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Preface 


So, you want to program your own games using Unreal Engine 4 (UE4). You have 
a great number of reasons to do so: 


e UE4is powerful: UE4 provides some of the most state-of-the-art, beautiful, 
realistic lighting and physics effects, of the kind used by AAA Studios. 


e UE4is device-agnostic: Code written for UE4 will work on Windows 
desktop machines, Mac desktop machines, Android devices, and iOS 
devices (at the time of writing this book—even more devices may be 
supported in the future). 


So, you can use UE4 to write the main parts of your game once, and after that, 
deploy to iOS and Android Marketplaces without a hitch. (Of course, there will 
be a few hitches: iOS and Android tn app purchases will have to be programmed 
separately.) 


What is a game engine anyway? 

A game engine is analogous to a car engine: the game engine is what drives the 
game. You will tell the engine what you want, and (using C+ code and the UE4 
editor) the engine will be responsible for actually making that happen. 


You will build your game around the UE4 game engine, similar to how the body and 
wheels are built around an actual car engine. When you ship a game with U E4, you 
are basically customizing the UE4 engine and retroptting it with your own game's 
graphics, sounds, and code. 
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What will using UE4 cost me? 


The answer, in short, is $19 and 5 percent of sales. 
"What?" you say. $19? 


That's right. For only $19, you get full access to a world class AAA Engine, complete 
with asource. This is a great bargain, considering the fact that other engines can cost 
anywhere from $500 to $1,000 for just a single license. 


Why don't I just program my own engine 
and save the 5 percent? 


Take it from me, if you want to create games within a reasonable time frame and you 
don't have a large team of dedicated engine programmers to help you, you'll want to 
focus your efforts on what you sell (your game). 


N ot having to focus on programming a game engine gives you the freedom to think 
only about how to make the actual game. N ot having to maintain and bug-þx your 
own engine is a load off your mind too. 


A game's overview — the Play-Reward- 
Growth loop 


| want to show you this diagram now because it contains a core concept that many 
novice developers might miss when writing their prst games. A game can be complete 
with sound effects, graphics, realistic physics, and yet, still not fee like a game. Why 

is that? 





- Perfect monsters 
nak world 


Result in 


- Item “(25 
- Purchase powerups Growth Reward - Coin, 
- Level of aS zG 


al 








—— _§_ oo —— [2] 
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Starting at the top of the loop, Play actions committed during the game (such as 
defeating a monster) result in rewards for the player (such as gold or experience). 
These rewards, in turn, can be used for in-game Growth (such as stats Increases 

or new worlds to explore). This Growth then drives the gameplay in new and 
interesting ways. For example, anew weapon can change the basic mechanics of 
bghting, new spells let you take on groups of monsters with a completely different 
approach, or new modes of transportation can let you reach areas that were 
previously inaccessible. 


This ts the basic core loop that creates interesting gameplay. The key is that Play 
must result in some kind of Reward—think of glittering gold pieces popping out of 
nasty baddies. For rewards to havea point, it must result in some kind of Growth in 
the gameplay. Think about how many new locations were unlocked with the hook 
shot in The Legend of Zelda. 


A game that is only Play (without Rewards or Growth) won't feel like a game: it 
will feel only like a really basic prototype of a game. For example, imagine a yight 
simulator with just an open world and no goals or objectives as well as without the 
ability to upgrade your plane or weapons. It wouldn't be much of a game. 


A game with only Play and Rewards (but no Growth) will feel primitive and simple. 
The rewards will not satisfy the player if they cannot be used for anything. 


A game with only Play and Growth (without Rewards) will just be seen as a 
mindless increasing challenge, without giving the player a sense of gratipcation 
for his achievements. 


A game with all three elements will keep the player engaged with an entertaining 
Play. The Play has arewarding result (loot drops and story progression), which 
results in the Growth of the game world. Keeping this loop in mind while you are 
devising your game will really help you to design a complete game. 


my A prototype is the proof of concept of a game. Say, you want to create 
Q your own unique version of Blackjack. The prst thing you might do is 
program a prototype to show how the game will be played. 


Monetization 


Something you need to think about early in your game's development is your 
monetization strategy. How will your game make money? If you are trying to start 
a company, you have to think of what will be your sources of revenue from early on. 


[3] 
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Areyou going to try to make money from the purchase price, such as Jamestown, 
The Banner Saga, Castle Crashers, or Crypt of the N ecrodancer? Or, will you focus on 
distributing a free game with in-app purchases, such as Clash of Clans, Candy Crush 
Saga, or Subway Surfers? 


A class of games for mobile devices (for example, builder games on iOS) make lots 
of money by allowing the user to pay in order to skip Play and jump straight to the 
rewards and Growth parts of the loop. The pull to do this can be very powerful; 
many people spend hundreds of dollars on asingle game. 


Why C++ 


UE4 Is programmed in C+ To write code for UE4, you must know CH. 


C+ is a common choice for game programmers because it offers very good 
performance combined with object-oriented programming features. It's a very 
powerful and yexible language. 


What this book covers 


Chapter 1, Coding with C++, talks about getting up and running with your prst 
C++ program. 


Chapter 2, Variables and M emory, talks about how to create, read, and write variables 
from computer memory. 


Chapter 3, If, Else, and Switch, talks about branching the code: that is, allowing 
different sections of the code to execute, depending on program conditions. 


Chapter 4, Looping, discusses how we repeat a specifbc section of code as many times 
as needed. 


Chapter 5, Functions and M acros, talks about functions, which are bundles of code that 
can get called any number of times, as often you wish. 


Chapter 6, Objects, Classes, and Inheritance, talks about class depnitions and 
instantiating some objects based on a class depnition. 


Chapter 7, Dynamic M emory Allocation, discusses heap-allocated objects as well as 
low-level C and C++ style arrays. 


Chapter 8, Actors and Pawns, is the prst chapter where we actually delve into UE4 
code. We begin by creating agame world to put actors in, and derivean Avat ar 
class from a customized actor. 
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Chapter 9, Templates and Commonly U sed Containers, explores UE4 and the C++ STL 
family of collections of data, called containers. Often, a programming problem can be 
simpliped many times by selecting the right type of container. 


Chapter 10, Inventory System and Pickup Items, discusses the creation of an inventory 
system with the ability to pick up new items. 


Chapter 11, M onsters, teaches how to create monsters that give chase to the player 
and attack it with weapons. 


Chapter 12, Spell Book, teaches how to create and cast spells in our game. 


What you need for this book 


To work with this text, you will need two programs. The prst is your integrated 
development environment, or IDE. The second piece of software is, of course, the 
Unreal Engine itself. 


If you are using Microsoft Windows, then you will need Microsoft Visual Studio 2013 
Express Edition for Windows Desktop. If you are using a Mac, then you will need 
Xcode. Unreal Engine can be downloaded fromht t ps:// www. unreal engine. com. 


Who this book is for 


This book is for anyone who wants to write an Unreal Engine application. The text 
begins by telling you how to compile and run your prst C++ application, followed 

by chapters that describe the rules of the C++ programming language. After the 
Introductory C++ chapters, you can start to build your own game application in C+. 


Conventions 


In this book, you will pnd a number of styles of text that distinguish between 
different kinds of information. Here are some examples of these styles, and an 
explanation of their meaning. 


Code words in text, database table names, folder names, blenames, ple extensions, 
pathnames, dummy URLs, user input, and Twitter handles are shown as follows: 
"Thevariabl eType is going to tell you what type of data we are going to store in 
our variable. Thevari abl eName isthesymbol we'll use to read or write that piece 
of memory". 
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A block of code is set as follows: 


Struct Player 
{ 
string name: 
int hop; 
|| A member function that reduces player hp by some amount 
void damage( int amount ) { 
hp -= amount; 
} 
void recover( int amount ) { 
hp += amount; 
} 
ie 


N ew terms and important words are shown in bold. Text that appears on the screen 
appears like this: From the File menu, select N ew Project... 


Extra information that is relevant, but kind of aside 
j. note, appears in boxes like this. 


a4 
| Q Tips and tricks appear like this. | 


Reader feedback 


Feedback from our readers is always welcome. Let us Know what you think about 
this book—what you liked or may have disliked. Reader feedback is important for 
us to develop titles that you really get the most out of. 


To send us general feedback, simply send an e-mail tof eedback @packt pub. com, 
and mention the book title via the subject of your message. 


If there is a topic that you have expertise in and you are interested in either writing 
or contributing to a book, see our author guide on www. packt pub. com authors. 


Customer support 


Now that you are the proud owner of a Packt book, we have a number of things 
to help you to get the most from your purchase. 


[6] 
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Downloading the example code 


You can download the example code bles for all Packt books you have purchased 
from your account atht tp: // www. packt pub. com. If you purchased this book 
elsewhere, you can visitht tp: // www. packt pub. com/support and register to have 
the bles e-mailed directly to you. 


Downloading the color images of this book 


We also provide you with a PDF ble that has color images of the screenshots/ 
diagrams used in this book. The color images will help you better understand the 
changes in the output. You can download this blefromhttps:// www. packt pub. 
com/sites/default/files/downloads/65720T Coloredl mages. pdf. 


Errata 


Although we have taken every care to ensure the accuracy of our content, mistakes 

do happen. If you pnd a mistake in one of our booksn maybe a mistake in the text or 
the code—we would be grateful if you would report this to us. By doing so, you can 
save other readers from frustration and help us improve subsequent versions of this 
book. If you pnd any errata, please report them by visitinght tp: // www. packt pub. 
com/ submit -errata,Seecting your book, clicking on the errata submission form link, 
and entering the details of your errata. Once your errata are veriped, your submission 
will be accepted and the errata will be uploaded on our website, or added to any list of 
existing errata, under the Errata section of that title. Any existing errata can be viewed 
by selecting your titlefromht tp: // www. packt pub. com/ support. 


Piracy 

Piracy of copyright material on the Internet is an ongoing problem across all media. 
At Packt, we take the protection of our copyright and licenses very seriously. If you 
come across any illegal copies of our works, in any form, on the Internet, please 
provide us with the location address or website name immediately so that we can 
pursue a remedy. 


Please contact us atcopyright @packt pub. com with a link to the suspected 
pirated material. 


We appreciate your help in protecting our authors, and our ability to bring you 
valuable content. 
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Questions 


You can contact us atguestions@packt pub. comif you are having a problem with 
any aspect of the book, and we will do our best to address It. 


www.it-ebooks.info 





Coding with C++ 


You're a prst-time programmer. You have a lot to learn! 


Academics often describe programming concepts in theory but like to leave 
implementation to someone else, preferably someone from the industry. We don't do 
that in this book—in this book, we will describe the theory behind C++ concepts and 
Implement our own game as well. 


The prst thing | will recommend is that you do the exercises. You cannot learn to 
program simply by reading. You must work with the theory with the exercises. 


Weare going to get started by programming very simple programs in C+. | know 
that you want to start playing your pnished game right now. However, you haveto 
start at the beginning to get to that end (if you really want to, skip over to Chapter 12, 
Spell Book, or open some of the samples to get a feel for where we are going). 


In this chapter, we will cover the following topics: 


e Setting up anew project (in Visual Studio and Xcode) 
e Your þrst C+ project 

e How to handle errors 

e What are building and compiling? 


Setting up our project 

Our prst C++ program will be written outside of UE4. To start with, | will provide 
steps for both Xcode and Visual Studio 2013, but after this chapter, | will try to 
talk about just the C+ code without reference to whether you're using Microsoft 
Windows or Mac OS. 
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Using Microsoft Visual C++ on Windows 


In this section, we will install a code editor for Windows, Microsoft's Visual Studio. 
Please skip to the next section if you are using a Mac. 


The Express edition of Visual Studio is the free version of Visual 
Studio that Microsoft provides on their website. Gotoht tp: // 
www. visualstudio.com/en-us/products/visual- 
Studi o-express-vs.aspx to start the installation process. 


To start, you have to download and install M tcrosoft Visual Studio Express 2013 for 
Windows Desktop. This is how theicon for the software looks: 


al 


Q 


Er araa 2013 for 
indows Desktop 


Visual 


Studio 





Microsoft 


Do not install Express 2013 for Windows. This is a different package 
and it is used for different things than what we are doing here. 


Once you have Visual Studio 2013 Express installed, open it. Work through the 
following steps to get to a point where you can actually type in the code: 


1. Fromthe File menu, select N ew Project..., as shown in the following 


screenshot: 


og Start Page - Microsoft Yisual Studio Express 2013 f 


EDIT WIEW DE BUG TE A" TOOLS TEST WIN Ca! 
Hew Project... ctri+shift+H 


fe New Team Project... 


New File... ctr1+n 


open Project... ctri+shifta 


open File... ctrl+o 


Open from Source Contral 


2 Connect to Team Project... 


Close 


Close Solution 





Save Selected Items 
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2. You will get the following dialog: 


New Project REI 


b Recent Sort by: | Default ~ as Search Installed Templates (ctrl+E. p ~ 
4 Installed Ss 


2C Win32 Console Application Visual C++ Type: visual C++ 
4 Templates `y z = A project for creating a Win32 
b visual Basic ++ B . console application 
b visual c# Win32 Project Visual C++ 
14 visual c++) ++ 
LR Wa Empty Project Visual C++ 
General ++ 
Test D Makefile Project Visual C++ 
Win32 
SOL Server 


Visual Studio Solutions 
Samples 


b Online 


3 Click here to go online and find templates. 


Name: MyFirstapp 


Location: A —p lc: \crr\ X Browse... | 


Solution name: MyFirstapp v| Create directory for solution 














E 4dd to source control 


N cancel 





N ote that there is a small box at the bottom with the text Solution 
A! name. In general, Visual Studio Solutions might contain many 
Q projects. H owever, this book only works with a single project, but at 
times, you might þnd it useful to integrate many projects into the same 
solution. 


3. Therearebve things to take care of now, as follows: 
1. Select Visual C++ from the left-hand side panel. 
Select Win32 Console A pplication from the right-hand side panel. 
Name your app (I used MyFirstApp). 
Select a folder to save your code. 
Click on the OK button. 


m BW N 
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4. After this an Application Wizard dialog box opens up, as shown in the 
following screenshot: 


Win32 Application Wizard - MyFirstApp 


Application Settings 


Overview Application type: Add common header files for: 


ce . (O Windows application 
Application Settings 5 


Gye Console application 
© © BU 


(© Static library 
Additional options: 

Empty project 

lewis rite® 

L] Precompiled header 


Security Development Lifecycle (SDL) 
checks 


< Previous | Next >= Finish | Cancel | 





5. Wehave four things to take care of in this dialog box, as follows: 
1. Click on Application Settings in the left-hand side panel. 
2. Ensurethat Console application is selected. 
3. Select Empty project. 
4. Click on Finish. 


Now you arein the Visual Studio 2013 environment. This is the place where you will 
do all your work and code. 
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However, we need a bleto write our code into. So, we will add aC++ code ple to our 


project, as shown in the following screenshot: 


es | MyFirstApp - Microsoft Visual Studio Express 2013 for Windows Desktop (Administrator) 


FILE EDIT VIEW PROJECT BUILD 


-ol|@aomw|o-¢c- 


DEBUG TEAM TOOLS TEST WINDOW HELP 





> Local Windows Debugger ~ Debug -| win32 
L J 


~|| is 





xOgTOoL Pett 


New Item... 
Existing Item... 
New Filter 
References... 
Class... 


Resource... 
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Quick Launch (ctr1+9) 


@\o-o @ials~ 
Search Solution Explorer (ctr1+;} 


wd Solution 'myFirstapp' (1 project) 


Build 
y Heade 
a Resou 
sg Sourc 


Rebuild 
Project Only 
Scope to This 
New Solution Explorer view 
Build Dependencies 


ctrl+shift+a © add 


shift+alt+a Class Wizard... Ctrl+shift+x 


a 
PA Manage NuGet Packages... 


Set as StartUp Project 


shift+alt+c Debug 


Source Control 


cut ctr1+x 
Properties 

Paste ctrl+v 
MyFirstapp Proje 


Remove Del 
fe: Rename F2 


(Name) Unload Project 


Project Depen¢ Rescan Solution 


Root Namespace e Open Folder in File Explorer 


& Properties 


Add New Item - MyFirstApp 21x) 





4 Installed Sort by: | pefault X 


@ Visual C++ 
UI © Ci C++ File (.cpp) 


code ++ 
[h] Header File (¢.h) 








web 

Test 

utility 
Property Sheets 


b Online 


visual C++ 


Search Installed Templates (ctrl+E p bd 


Type: Visual C++ 


Creates a file containing C++ source 
code 


Visual C++ 


Click here to go online and find templates. 


Name: Source.cpp 





Location: | C:\cPP\yFirstapp iyFirst app’, 


-| Browse... | 





aa | 





You will now editSource. cpp. Skip to the Your First C+ Program section and type 


in your code. 


a [13 ] AA YN 


www.it-ebooks.info 


Coding with C++ 


Using XCode on a Mac 


In this section, we will talk about how to install Xcode on a Mac. Please skip to the 
next section if you are using Windows. 


Xcode is available on all Mac machines. You can get Xcode using the Apple App 
Store (it's free), as shown here: 


Search Results for “xcode” 


=> Xcode 


Developer Tools 
Www ws 70 Ratings 
“INSTALLED | © ' 





1. Once you have Xcode installed, open it. Then, navigate to File | New | 
Project... from the system's menu bar at the top of your screen, as shown 
in the following screenshot: 


| @& Xcode (FN Edit View Find Navigate Editor Product Deb 


Open... 
Open Recent 


Open Quickly... 
. = Workspace... 
Close Window 
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In the N ew Project dialog, select Application under OS X on the left-hand 
side of the screen, and select Command Line Tool from the right-hand side 
pane. Then, click on Next: 


Choose a template for your new project 


| ios 
Application 
Framework & Library 
Other 


& Osx 


A &€ 4 m 

Ñ i 

Cocoa Application SpriteKit Game Cocoa-AppleScript Command Line Tool 
Application 


[maid i iai || 
Framework & Library 


Application Plug-in 
System Plug-in 
Other 


You might be tempted to click on the SpriteKit Game 
va f 


ec 


| , Command Line Tool 


This template builds a command-line tool. 





icon, but don't click on it. 


In the next dialog, name your project. Be sure to pll in all the belds or Xcode 
won't let you proceed. Make sure that the project's Type is set to C ++ and 
then click on the N ext button, as shown here: 


Choose options for your new project: 


— 





Product Name | MyFirstApp| | 


| Organization Name ‘William Sherif 


| Company Identifier | com.mycompany 


Bundle Identifier com.mycompany.My 


Type 





Cancel Previous 
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4. Thenext popup will ask you to choose a location in order to save your 
project. Pick a spot on your hard drive and save it there. Xcode, by default, 
creates a Git repository for every project you create. You can uncheck 
Create git repository —we won't cover Git in this chapter—as shown 
in the following screenshot: 


a\p|{ 2 [= l m| m || & 


FAVORITES 
E| Desktop 
J Applications 


Source Control: |_| Create git repository on M 





New Folder Cancel | Create | 


Git is a V ersion control system. This basically means that Git keeps 
the snapshots of all the code in your project every so often (every 

A time you commit to the repository). Other popular source control 
management tools (scm) are M ercurial, Perforce, and Subversion. 
When multiple people are collaborating on the same project, the scm 
tool has the ability to automatically merge and copy other people's 
changes from the repository to your local code base. 
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Okay! You areall set up. Click on the main.cpp plein the left-hand side pane! of 
Xcode. If the ple doesn't appear, ensure that the folder icon at the top of the left-hand 
side pane is selected prst, as shown in the following screenshot: 


00909 T MyFirstApp ol main.cpp 


> ) WF MyFirstApp | u My Mac 64-bit Finished running MyFirstApp : MyFirstApp 


(1)ia = Q A = = => Q = 4 TA MyFirstApp L | MyFirstApp > 6 main.cpp > No Selection 
m, MyFirstApp 


y marn. cpp 
MyFirstApp 


x | MyFirstApp Created by William Sherif on 7/21/14 
—_ | Gxt Copyright ic) 2014 W am She ‘ 


MyFirstApp. 1 


t, OS X SDK 10.9 


> L Products include <iostream> 


int main(int argc, const char * argv[]) 


isert code here 
i cout << “Hello, lor 
return @; 


} 





Etgcvpi '{ qw'OtuvE-- 'r tqi tco 


Weare now going to write some C++ source code. There is a very good reason why 
we are calling it the source code: it is the source from which we will build our binary 
executable code. The same C++ source code can be built on different platforms such 
as Mac, Windows, and iOS, and in theory, an executable code doing the exact same 
things on each respective platform should result. 


In the not-so-distant past, before the introduction of C and C+, programmers 
wrote code for each specifoc machine they were targeting individually. They wrote 
code in a language called assembly language. But now, with C and C++ available, 
a programmer only has to write code once, and it can be deployed to anumber of 
different machines simply by sending the same code through different compilers. 


In practice, there are some differences between Visual Studio's yavor 
of C++and Xcode's yavor of C, but these differences mostly come 
A! up when working with advanced C++ concepts, such as templates. 
Q One of the main reasons why using UE4is so helpful is that U E4 will 
erase a lot of the differences between Windows and Mac. The UE4 
team did alot of magic in order to get the same code to work on both 
Windows and Mac. 
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A real-world tip 


It is important for the code to run in the same way on all machines, 


> especially for networked games or games that allow things such as 
Shareable replays. This can be achieved using standards. For example, 
the IEEE yoating-point standard is used to implement decimal math on 
all C++ compilers. This means that the result of computations such as 
200 * 3.14159 should bethesame on all the machines. 


Write the following code in Microsoft Visual Studio or in Xcode: 


#include <iostream> // Import the input-output library 
using namespace std; // allows us to write cout 
|| instead of std::cout 


int main() 
{ 
cout << "Hello, world" << endl; 
cout << "I am now a C++ programmer." << endl: 
return 0: || "return" to the operating sys 
} 


Press Ctrl +F5 to run the preceding codein Visual Studio, or press a6 +R torun 
in Xcode. 


The prst time you press Ctrl +F5 in Visual Studio, you will see this dialog: 


Microsoft Yisual Studio Express 2013 fo... 


This project is aut of date: 


MyFirstapp - Debug wins? 


Would you like ta build it? 


(rep m | cae | 


o not show this dialog again 





Select Yes and Do not show this dialog again—trust me, this will avoid 
future problems. 
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The prst thing that might come to your mind ts, "My! A whole lot of gibberish!" 


Indeed, you rarely see the use of the hash (#) symbol (unless you use Twitter) and 
curly brace pairs { } in normal English texts. However, in C+ code, these strange 
symbols abound. You just have to get used to them. 


So, let's interpret this program, starting from the prst line. 
This ts the prst line of the program: 

#include <iostream> // Import the input-output library 
This line has two important points to be noted: 


1. Theprst thing we see isan +#include statement. Weare asking C++ to copy 
and paste the contents of another C++ source ple, called <i ost ream>, directly 
into our code ble. The<i ost ream> isastandard C++ library that handles all 
the sticky code that lets us print text to the screen. 


2. Thesecond thing wenoticeisa// comment. C++ignores any text after a 
double slash (/ / ) until the end of that line. Comments are very useful to add 
in plain text explanations of what some code does. You might also see/ * 
* 1 C-style comments in the source. Surrounding any text in C or C++ with 
Slash-star / * and star-slash */ gives an instruction to have that code removed 
by the compiler. 


This is the next line of code: 


using namespace std; // allows us to write cout 
|| instead of std::cout 


The comments beside this line explain what theusi ng statement does: it just lets you 
use a shorthand (for example, cout ) instead of the fully qualifed name (which, in 
this case, would best d:: cout ) for alot of our C+ code commands. Some people 
don'tlikeausing namespace std; statement; they prefer to writethest d:: cout 
longhand every time they want to usec out . You can get into long arguments over 
things like this. In this section of the text, we prefer the brevity that we get with the 
using namespace std; Statement. 


This is the next line: 


int main() 
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This ts the application's starting point. You can think of mai n asthe start lineina 
race. Thei nt main() statement is how your C++ program knows where to start; 
take a look at the following bgure: 





If you don'thaveani nt main() program marker or if mai n is spelled incorrectly, 
then your program just won't work because the program won't know where to start. 


The next line is a character you don't see often: 
{ 


This { character is not a sideways mustache. It is called a curly brace, and it denotes 
the starting point of your program. 


The next two lines print text to the screen: 


cout << "Hello, world" << endl: 
cout << "I am now a C++ programmer." << endl: 


Thecout statement stands for console output. Text between double quotes will get 
an output to the console exactly as it appears between the quotes. You can write 
anything you want between double quotes except a double quote and it will still be 
valid code. 


To enter a double quote between double quotes, you need to stick a 
backslash (\ ) in front of the double quote character that you want inside 


al the string, as shown here: 


7 cout << "John shouted into the cave \"Hello!\" The 
cave echoed." 
The\ symbol is an example of an escape sequence. There are other 
escape sequences that you can use; the most common escape sequence 
you will pnd is\ n, which is used to jump the text output to the next line. 
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The last line of the program is ther et urn statement: 


return 0: 


This line of code indicates that the C+ program is quitting. You can think of the 
return Statement as returning to the operating system. 


Finally, the end of your program is denoted by the closing curly brace, which is an 
opposite-facing sideways mustache: 


} 


Semicolons 


Semicolons (;) are important in C+ programming. Notice in the preceding code 
example that most lines of code end in a semicolon. If you don't end each line with 
a semicolon, your code will not compile, and if that happens, you can be pred from 
your job. 


Handling errors 


If you make a mistake while entering code, then you will havea syntax error. In 
the face of syntax errors, C++ will scream murder and your program will not even 
compile; also, it will not run. 


Let's try to insert a couple of errors into our C++ code from earlier: 


#include-<iostreams>] 
using-namespace-std;] 
int-maind(] 

{11 


- -count . <<- "Hello, -world-<<-ender:] 
--count-<<-"I-am-nowb-a-C++-programmer."-<<-ender;] 


+1 





Warning! This code listing contains errors. It is a good exercise to find all the errors and fix them! 


Asan exercise, try to pnd and bx all the errors in this program. 


Note that if you are extremely new to C+, this might bea 
NS hard exercise. However, this will show you how careful you 
i need to be when writing C++ code. 
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Fixing compilation errors can be a nasty business. However, if you input the text 

of this program into your code editor and try to compile it, it will cause the compiler 
to report all the errors to you. Fix the errors, one at a time, and then try to recompile. 
A new error will pop up or the program will just work, as shown in the following 
screenshot: 


i #include <iostreams> $ ‘ostreams' file not found 
using namespace std; 


4 int maind( 
{ 


count << "Hello, worid << ender: 
count << "I am nowb a C++ programmer.” << ender; 





Xcode shows you the errors in your code when you try to compile it 


The reason | am showing you this sample program is to encourage the following 
workyow as long as you are new to C+ 


1. Always start with a working C++ code example. You can fork off a bunch of 
new C++ programs from the Y our First C++ Program section. 


2. Makeyour code modipcations in small steps. When you are new, compile 
after writing each new line of code. Do not code for one to two hours and 
then compile all that new code at once. 


3. You can expect it to be a couple of months before you can write code that 
performs as expected the prst time you write it. Don't get discouraged. 
Learning to code Is fun. 


Warnings 


The compiler will yag things that it thinks might be mistakes. These are another class 
of compiler notices known as warnings. Warnings are problems in your code that 
you do not have to bx for your code to run but are simply recommended to be bxed 
by the compiler. Warnings are often indications of code that is not quite perfect, and 
bxing warnings in code is generally considered good practice. 


However, not all warnings are going to cause problems in your code. Some 
programmers prefer to disable the warnings that they do not consider to be an issue 
(for example, warning 4018 warns against signed/ unsigned mismatch, which you 
will most likely see later). 


[ 22 ] 


www.it-ebooks.info 


Chapter 1 


What is building and compiling? 

You might have heard of a computer process term called compiling. Compiling is the 
process of converting your C++ program into code that can run on a CPU. Building 
your source code means the same thing as compiling it. 


See, your sourcecode. cpp Plewill not actually run on a computer. It has to be 
compiled prst for it to run. 


This ts the whole point of using Microsoft Visual Studio Express or Xcode. 
Visual Studio and Xcode are both compilers. You can write C+ source code 

in any text-editing program—even in Notepad. But you need a compiler to run 
it on your machine. 


Every operating system typically has one or more C++ compilers that can compile 
C++ code to run on that platform. On Windows, you have Visual Studio and Intel 
C+ Studio compiler. On Mac, there is Xcode, and on all of Windows, Mac, and 
Linux, there is the GNU Compiler Collection (GCC). 


The same C++ code that we write (Source) can be compiled using different compilers 
for different operating systems, and in theory, they should produce the same result. 
The ability to compile the same code on different platforms is called portability. In 
general, portability is a good thing. 


Scripting 

There is another class of programming languages called scripting languages. These 
include languages such as PHP, Python, and ActionScript. Scripted languages are 
not compiled—for JavaScript, PHP, and ActionScript, there is no compilation step. 
Rather, they are interpreted from the source as the program is run. The good thing 
about scripting languages is that they are usually platform-independent from the 
brst go, because interpreters are very carefully designed to be platform-independent. 


Exercise — ASCII art 


Game programmers love ASCII art. You can draw a picture using only characters. 
Here's an example of an ASCII art maze: 


cout << NEREKKREKKREKHEKK" << endi: 
COUT <L aa ce. 18 ee * *" << endl; 
coul <<. 13 SEER, ee ee Ent 
COUT << TR E aieeaa os +i << endl: 
cout << UK X K ERE AE HS ee << endl: 
COU: <4 TEPE PEF oe a ae *" << endl: 


Construct your own maze in C+ code or draw a picture using characters. 
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Summary 


To sum it up, we learned how to write our prst program in the C+- programming 
language In our integrated development environment (IDE, Visual Studio, or Xcode). 
This was asimple program, but you should count getting your prst program to 
compile and run as your prst victory. In the upcoming chapters, we'll put together 
more complex programs and start using Unreal Engine for our games. 


#include <iostream> // Import the input-output library 
=]using namespace std; // allows us to write cout 
// instead of std::cout 


-Jint main() 


{ 


cout << “Hello, world" << endl; 
cout << "I am now a C++ programmer." << endl; 
return 6; 





The preceding screenshot is of your prst C+ program and the following screenshot 
is of its output, your prst victory: 


CW i ndows \systemse\cm 


Hello, world 
I am now a G++ programmer. 


Press any key to continue ... 
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Variables and Memory 


To write your C++ game program, you will need your computer to remember a 
lot of things. Things such as where in the world is the player, how many hit points 
he has, how much ammunition he has left, where the items are in the world, what 
power-ups they provide, and the letters that make up the player's screen name. 


The computer that you have actually has a sort of electronic sketchpad inside it 
called memory, or RAM. Physically, computer memory is made out of silicon and it 
looks something similar to what is shown in the following screenshot: 


‘ULT31897 


O45MB por ane go 
SAME OMHz 


pa VOID ie Moven 





Does this RAM look like a parking garage? Because that's the metaphor we're going to use 


RAM is short for Random Access Memory. It is called random access because you 
can access any part of it at any time. If you still have some CDs lying around, they 
are an example of non-random access. CDs are meant to be read and played back 
in order. | still remember jumping tracks on Michael Jackson's D angerous album 
way back when switching tracks on aCD took a lot of time! Hopping around and 
accessing different cells of RAM, however, doesn't take much time at all. RAM isa 
type of fast memory access known as yash memory. 


RAM is called volatile yash memory because when the computer is shut down, 
RA M's contents are cleared and the old contents of RAM are lost unless they were 
saved to the hard disk prst. 
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For permanent storage, you have to save your data into a hard disk. There are two 
main types of hard disks, platter-based Hard Disk Drives (HD Ds) and Solid-state 
Drives (SSDs). SSDs are more modern than platter-based HDDs, since they use 
RA M's fast-access (Flash) memory principle. Unlike RAM, however, the data on 

an SSD persists after the computer is shut down. If you can get an SSD, I'd highly 
recommend that you use it! Platter-based drives are outdated. We need a way to 
reserve a space on the RAM and read and write from it. Fortunately, C++ makes 
this easy. 


Variables 


A saved location in computer memory that we can read or write to is called a variable. 


A variable is a component whose value can vary. In a computer program, you 

can think of a variable as a container, into which you can store some data. In C, 
these data containers (variables) have types. You have to use the right type of data 
container to save your data in your program. 


If you want to save an integer, such as 1, 0, or 20, you will use ani nt type container. 
You can use yoat-type containers to carry around yoating-point (decimal) values, 
such as 38.87, and you can use string variables to carry around strings of letters 
(think of it as a "string of pearls", where each letter is a pearl). 


You can think of your reserved spot in RAM like reserving parking spaceina 
parking garage: once we declare our variable and get a spot for it, no one else (not 
even other programs running on the same machine) will be given that piece of RAM 
by the operating system. The RAM beside your variable might be unused or it might 
be used by other programs. 


The operating system exists to keep programs from stepping on each 
i other's toes and accessing the same bits of computer hardware at the 
~ same time. In general, civil computer programs should not read or write 
Q to each other's memory. H owever, some types of cheat programs (for 
example, maphacks) secretly access your program's memory. Programs 
such as PunkBuster were introduced to prevent cheating in online games. 


Declaring variables — touching the silicon 


Reserving a spot on computer memory using C++ is easy. We'll want to name our 
chunk of memory that we will store our data in with a good, descriptive name. 


[26] 


www.it-ebooks.info 


Chapter 2 


For example, say, we know that player hit points (hp) will bean integer (whole) 
number, such as 1, 2, 3, or 100. To get a piece of silicon to store the player's hp in 
memory, we will declare the following line of code: 


int hop; // declare variable to store the player's hop 


This line of code reserves a small chunk of RAM to store an integer (i nt is short for 
integer), called hp. The following is an example of our chunk of RAM used to store 
the player's hp. This reserves a parking space for us in memory (among all the other 
parking spaces), and we can refer to this soacein memory by its label (hp). 





Among all the other spaces in memory, we get one spot to store our hp data 


N otice how the variable space is type-marked in this diagram as int: if it is a space 
for a double or a different type of variable. C++ remembers the spaces that you 
reserve for your program in memory not only by name but by the type of variable it 
is as well. 


Notice that we haven't put anything in hp's box yet! We'll do that latern right now, 
the value of the hp variable is not set, so it will have the value that was left in that 
parking space by the previous occupant (the value left behind by another program, 
perhaps). Telling C++ the type of the variable is important! Later, we will declare a 
variable to store decimal values, such as 3.75. 


Reading and writing to your reserved spot in 


memory 
Writing a value into memory is easy! Once you haveanhp variable, you just write to 
it using the= sign: 


hp = 500: 
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Voila! The player has 500 hp. 


Reading the variable is equally simple. To print out the value of the variable, simply 
put this: 


cout << hp << endl; 


This will print the value stored inside the hp variable. If you change the value of hp, 
and then usecout again, the most up-to-date value will be printed, as shown here: 


hp = 1200; 
cout << hp << endl; // now shows 1200 


Numbers are everything 


Something that you need to get used to when you start computer programming 
is that a surprising number of things can be stored in computer memory as just 
numbers. A player's hp? As we just saw in the previous section, hp can just be an 
integer number. If the player gets hurt, we reduce this number. If the player gains 
health, we increase the number. 


Colors can be stored as numbers too! If you've used standard image editing 
programs, there are usually sliders that indicate color as how much red, green, and 
blue are being used, such as Pixelmator's color sliders. A color is then represented by 
three numbers. The purple color shown in the following screenshot is (R=127, G=34, 
B=203): 


[m m] iHe ajira 
Eo 


1 


[E] | RGB Sliders 
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What about world geometry? These are also just numbers: all we haveto do is store 
alist of 3D space points (x, y, and z coordinates) and then store another list of points 
that explain how those points can be connected to form triangles. In the following 
screenshot, we can see how 3D space points are used to represent world geometry: 





The combination of numbers for colors and numbers for 3D space points will let you 
draw large and colored landscapes in your game world. 


The trick with the preceding examples is how we interpret the stored numbers so 
that we can make them mean what we want them to mean. 


More on variables 


You can think of variables as animal-carrying cases. A cat carrier can be used to carry 
a cat, but not a dog. Similarly, you should use a yoat-type variable to carry decimal- 
valued numbers. If you store a decimal value inside ani nt variable, it will not pt: 


int x = 38. 87f; 
cout << x << endl; // prints 38, not 38.87 


What's really happening here is that C++ does an automatic type conversion on 
38.87, transmogrifying it to an integer to bt in thei nt carrying case. It drops the 
decimal to convert 38.87 into the integer value 38. 
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So, for example, we can modify the code to include the use of three types of 
variables, as shown in the following code: 


#include <iostream> 
#include <string> // need this to use string variables! 
using namespace std; 
int main() 
{ 
string name: 
int goldPieces; 
float hp; 
name = "William"; // That's my name 
goldPieces = 322; // start with this much gold 
ip = 15.51 || hit points are decimal valued 
cout << "Character " << name << " has " 
<< hp << " hp and " 
<< goldPieces << " gold.'; 


} 


In the prst three lines, we declare three boxes to store our data parts into, 
as shown here: 


string name: 
int goldPieces; 
float hp; 


These three lines reserve three spots in memory (like parking spaces). The next three 
lines pll the variables with the values we desire, as follows: 


name = "Wiiliam", 
goldPieces = 322; 
hp = 75. 5f; 


In computer memory, this will look as shown in the following bgure: 


string 


William 


n a me gol dPi eces 





You can change the contents of a variable at any time. You can write a variable using 
the = assignment operator, as follows: 


goldPieces = 522;// = 1s called the “assignment operator" 
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You can also read the contents of a variable at any time. That's what the next three 
lines of code do, as shown here: 


cout << "Character " << name << " has " 
<< hp << " hp and " 
<< goldPieces << " gold.": 


Take a look at this line: 


cout << "I have " << hp << " hp." << endl: 


There are two uses of the word hp inthis line. Oneis between double quotes, while 
the other is not. Words between double quotes are always output exactly as you 
typed them. When double quotes are not used (for example, << hp <), avariable 
lookup is performed. If the variable does not exist, then you will get a compiler error 
(undeclared identiper). 


There is aspacein memory that is allocated for the name, a space for how many 
gol dPi eces the player has, and a space for the hp of the player. 


my In general, you should always try to store the right type of data 
Q inside the right type of variable. If you happen to store the wrong 
type of data, your code may misbehave. 


Math in C++ 


Math in C++ is easy to do; +(plus), - (minus), * (times), / (divide by) are all common 
C++ operations, and proper BEDMAS order will be followed (Brackets, Exponents, 
Division, Multiplication, Addition, and Subtraction). For example, we can do as 
shown in the following code: 


int answer = 277 +5 * 4 / 2 + 20: 


Another operator that you might not be familiar with yet is % (modulus). Modulus 
(for example, 10 % 3) pbnds the remainder of when x is divided by y . See the 
following table for examples: 


Operator (name) [Example [anwr 


+ (plus) 


“(minus 8-5 


* (times) 
/ (division 
% (modulus) 10% 3 1 (because 10/ 3 is 3 the remainder =1). 
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However, we often don't want to do math in this manner. Instead, we usually 
want to change the value of a variable by a certain computed amount. This isa 
concept that is harder to understand. Say the player encounters an imp and is 
dealt 15 damage. 


The following line of code will be used to reduce the player's hp by 15 (believe it 
or not): 


hp = hp. = 15; || probably confusing :) 


You might ask why. Because on the right-hand side, we are computing a new value 
for hp (hp- 15). After the new value for hp is found (15 less than what it was before), 
the new value is written into the hp variable. 


Pitfall 


An uninitialized variable has the bit pattern that was held in memory 
for it before. Declaring a variable does not clear the memory. So, say we 
used the following line of code: 


si int hp; 


a] 
Q hp = hp l5; 
The second line of code reduces the hp by 15 from its previous value. 
What was its previous value if we never set hp = 100 or so? It could be 
0, but not always. 


One of the most common errors is to proceed with using a variable 
without initializing it prst. 
The following is ashorthand syntax for doing this: 
hp -= 15; 


Besides - =, you can use +=to add some amount to a variable, *=to multiply a 
variable by an amount, and / =to dividea variable by some amount. 


Exercises 


Write down the value of x after performing the following operations; then, check 
with your compiler: 


int x = 900; 
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Generalized variable syntax 


In the previous section, you learned that every piece of data that you save in C++has 
a type. All variables are created in the same way; in C, variable declarations are of 
the form: 


variableType variabl eName; 


Thevari abl eType tells you what type of data we are going to store in our variable. 
Thevari ab! eName isthesymbol well use to read or write to that piece of memory. 


Primitive types 
We previously talked about how all the data inside a computer will at some point be 
a number. Your computer code is responsible for interpreting that number correctly. 


It is said that C++ only depnes a few basic data types, as shown in the following table: 


A single letter, such as ‘a’, 'b', or '+ 
An integer from -32,767 to +32,768 
An integer from -2,147,483,647 to +2,147,483,648 


Any decimal value from approx. -1x1038 to 1x1038 
Any decimal value from approx. -1x10308 to 1x10308 





There are unsigned versions of each of the variable types mentioned in the preceding 
table. An unsigned variable can contain natural numbers, including 0 (x >=0). An 
unsigned short , for example, might have a value between 0 and 65535. 


If you're further interested in the difference between yoat and 
double, please feel free to look it up on the Internet. | will keep my 

KISS explanations only to the most important C++ concepts used for 
games. If you are curious about something that's covered by this text, 
feel free to look it up. 
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It turns out that these simple data types alone can be used to construct arbitrarily 
complex programs. "How?" you ask. Isn't it hard to build a 3D game using just yoats 
and integers? 


Itis not really diffpcult to build a game from yoat and int, but more complex data 
types help. It will be tedious and messy to program if we used loose yoats for the 
player's position. 


Object types 


C++ gives you structures to group variables together, which will make your life a lot 
easier. Take an example of the following block of code: 


#include <iostream> 
using namespace std; 
struct Vector // BEGIN Vector OBJECT DEFINITION 
{ 
float x, Yy, Z; // x, y and z positions all floats 
ie || END Vector OB) ECT DEFINITION, 
|| The computer now knows what a Vector is 
|] So we can create one. 
int main() 
{ 
Vector v; // Create a Vector instance called v 
v.xX=20, v.y=30, v.z=40; // assign some values 


cout << "A 3-space vector at " << v.x << ", " << vViy << ", " << 
v.z << endl: 


} 


The way this looks in memory is pretty intuitive; a Vector is just a chunk of memory 
with three yoats, as shown in the following bgure: 


Vector 


Float Float Float 
.X -y F 
T 





a Don't confuse the struct Vector in the preceding screenshot with 
s thestd:: vector oftheSTL. The Vector object above is meant 
Q to represent a three-space vector, while STL'sst d: : vector type 
represents a sized collection of values. 
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H ere are a couple of review notes about the preceding code listing: 


First, even before we use our Vector object type, we have to depne it. C++ does not 
come with built-in types for math vectors (it only supports scalar numbers, and they 
thought that was enough!). So, C++ lets you build your own object constructions to 
make your life easier. We prst had the following depnition: 


Struct Vector || BEGIN Vector OBJECT DEFINITION 
{ 

float x, Y, Z; // x, y, and z positions all floats 
ie || END Vector OBJECT DEFINITION. 


This it tells the computer what a Vector is (it's 3 yoats, all of which are declared to be 
sitting next to each other in the memory). The way a Vector will look in the memory 
is shown in preceding þgure. 


Next, we use our Vector object deþnition to create a Vector instance called v : 


Vector v: // Create a Vector instance called v 


Thestruct Vector depnition doesn't actually create a Vector object. You can't do 
Vector.x = 1. "Which object instance are you talking about?" the C++ compiler will 
ask. You need to create a Vector instance prst, such as Vector v1; then, you can do 
assignments on the v1 instance, such as v1.x =0. 


We then use this instance to write values intov: 


v.x=20, v.y=30, v.z=40; // assign some values 


i We used commas in the preceding code to initialize a bunch of 
< variables on the same line. This is okay in C+. Although you 
Q can do each variable on its own line, the approach shown here 
is okay too. 


This makes v look as in the preceding screenshot. Then, we print them out: 


cout << "A 3-space vector at " << V.X << m = RE 


v.z << endl: 


Å Il << V. y << 


In both the lines of code here, we access the individual data members inside the 
object by simply using a dot (. ).v. x refers to thex member inside the object v . Each 
Vector object will have exactly three yoats inside it: one called x , one called y , and 
one called z. 
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Exercise — Player 


Deþne a C++ data struct for a Player object. Then, create an instance of your Player 
class and pll each of the data members with values. 


Solution 


Let's declare our Player object. We want to group together everything to do 

with the player into the Player object. We do this so that the code Is neat and tidy. 
The code you read in Unreal Engine will use objects such as these everywhere; so, 
pay attention: 


Struct Player 
{ 
string name: 
int hop; 
Vector position: 
}; LL Don't forget this semicolon at the end! 
int main() 
{ 
// create an object of type Player, 
Player me; // instance named ' me' 
me. name = "William'; 
me. hp = 100. Of; 
me.position.x = me. position. y = me. position. z=0; 
} 
The struct Player depnition is what tells the computer how a Player object is laid out 
in memory. 


i | hope you noticed the mandatory semicolon at the end of the 
“ struct declaration. struct object declarations need to havea 
Q semicolon at the end, but functions do not. This is just a C++ 
rule that you must remember. 


Inside a Player object, we declared a string for the player's name, a yoat for his hp, 
and a Vector object for his complete xyz position. 


When I say object, | mean a C+- struct (or later, we will introduce the term class). 
Wait! We put a Vector object inside a Player object! Yes, you can do that. 


After the deþnition of what a Player object has inside it, we actually create a Player 
object instance called me and assign it some values. 
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After the assignment, the me object looks as shown in the following pgure: 


String Float Vector 
Float Float Float 


Wiliam || 100 | | o | ol o| 
.X y Z 


„portion 





Pointers 


Chapter 2 


A particularly tricky concept to grasp is the concept of pointers. Pointers aren't that 


hard to understand but can take a while to get a prm handle on. 
Say we have, as before, declared a variable of the type Player in memory: 


Player me; 
me. name = "William': 
me.hp = 100. 0f; 


We now declare a pointer to the Player: 


Player* ptrMe; || Declaring a pointer 


The* characters usually make things special. In this case, the* makes pt r Me special. 


The* is what makes pt r Me a pointer type. 


We now want to link pt r Me to me: 
ptrMe = &me; [/ LINKAGE 


sl This linkage step is very important. If you don't link the pointer 


Q to an object before you use the pointer, you will get a memory 
access violation. 
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ptr Me now refers to the same object as me. Changing pt r Me will change me, 
as shown in the following pbgure: 


String Float Vector 


Float Float Float 
Wiliam || 100 | | o | ol o | 
.X y VA 

„hp 


.name „portion 





What can pointers do? 


When we s& up the linkage between the pointer variable and what it is pointing to, 
we can manipulate the variable that is pointed to through the pointer. 


One use of pointers is to refer to the same object from several different locations of 
the code. The Player object is a good candidate for being pointed to. You can create 
as many pointers as you wish to the same object. Objects that are pointed to do not 
necessarily know that they are being pointed at, but changes can be made to the 
object through the pointers. 


For instance, say the player got attacked. A reduction in his hp will result, and this 
reduction will be done using the pointer, as shown in the following code: 


ptrMe->hp -= 33; || reduced the player's hp by 33 
ptrMe->name = "John":;// changed his name to John 


Here's how the Player object looks now: 


Vector 
Float Float Float 
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So, we changed me. name by changing pt r Me- >name. Becausept r Me points to me, 
changes through pt r Me affect me directly. 


Besides the funky arrow syntax (use- > when the variable is a pointer), this concept 
isn't all that hard to understand. 


Address of operator & 


N otice the use of the & symbol in the preceding code example. The & operator gets 
the memory address of a variable. A variable’s memory address is where it lives in 
the computer memory space. C++ is able to get the memory address of any object 
in your program's memory. The address of a variable is unique and also, kind of, 
random. 


Say, we print the address of an integer variablex , as follows: 


At x S223 
cout << &x << endl; // print the address of x 


On the prst run of the program, my computer prints the following: 
0023F/44 


This number (the value of &x ) is just the memory cell where the variablex is stored. 
What this means is that in this particular launch of the program, the variablex is 
located at memory cell number 0023F 744, as shown in the following bgure: 





Now, create and assign a pointer variable to the address of x : 


int *px: 
px = &x; 
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What we're doing here is storing the memory address of x inside the variable p x . So, 
we are metaphorically pointing to the variablex using another different variable called 
px. This might look something similar to what is shown in the following bgure: 


m 22 E o — 





Here, the variablep x has the address of the variablex insideit. In other words, the 
variable px iS areference to another variable. Differencing px means to access the 
variable that px is referencing. Differencing is done using the* symbol: 


cout << *px << endl; 


The Null pointers 


A null pointer is a pointer variable with the value 0 . In general, most programmers 
like to initialize pointers to Null (0 ) on the creation of new pointer variables. 
Computer programs, in general, can't access the memory address 0 (it is reserved), 
so If you try to reference a Null pointer, your program will crash, as shown in the 
following screenshot: 


#include <iostream> 
using namespace std; &? app1.exe 


Sint main() Ca app1.exe has stopped working 


{ Windows can check online for a solution to the problem, 
int *x = @; 


cout << *x << endl; > Check online for a solution and close the program 


> Close the program 


> Debug the program 


~| view problem details 
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al 


i Pointer Fun with Binky is a fun video about pointers. Take a look at 
http://www. youtube. com watch?v=i49 SNt4yfk. 


cin 

cin isthe way C++traditionally takes input from the user into the program. ci n is 
easy to use, because it looks at the type of variable it will put the value into as it puts 
itin. For example, say we want to ask the user his age and store itin ani nt variable 
We can do that as follows: 


cout << "What is your age?" << endl: 
int age; 
cin >> age: 


printf() 


Although we have used cout to print out variables so far, you need to know about 
another common function that is used to print to the console. This function is called 
theprintf function. Thepri ntf function is included in the<i ost ream> library, 
so you don't have to #i ncl ude anything extra to use it. Some people in the gaming 
industry prefer printf tocout (I Know I do), so let's introduce it. 


Let's proceed to how pri nt f() works, as shown in the following code: 


#include <iostream> 
#include <string> 
using namespace std: 


int main() 
{ 

char character = 'A'; 

int integer = 1; 

printf( “integer %d, character %c\n", Integer, character ); 
} 


D ownloading the example code 


A You can download the example code ples from your account at 
`‘ http://www. packtpub. com for all the Packt Publishing books you 
Q have purchased. If you purchased this book elsewhere, you can visit 
http://www. packtpub.com/ support and register to have the ples 
emailed directly to you. 
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We start with a format string. The format string is like a picture frame, and the 
variables will get plugged in at the locations of the % in the format string. Then, the 
entire thing gets dumped out to the console. In the preceding example, the integer 
variable will be plugged into the location of the prst % (%d ), and the character will be 
plugged into the location of the second % (%c ), as shown in the following screenshot: 


printf( "integer|%d, character %c\n", 





You have to use the right format code to get the output to format correctly; takea 
look at the following table: 


Datatype 


Deka i 
rsring Sidi 


To print a C+ string, you must usethestring.c_str() function: 





string s = "Hello"; 
printf( “string %s\n", s.c_str() ); 


Thes.c_str() function accesses the C pointer to the string, which pri nt f needs. 


If you use the wrong format code, the output won't appear correctly or the program 
might crash. 


Exercise 


Ask the user his name and age and take them in using ci n. Then, issue a greeting for 
him at the console using printf () (notcout ). 


Solution 


This is how the program will look: 


#include <iostream> 
#include <string> 
using namespace std: 
int main() 
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cout << "Name?" << endl: 
string name: 
cin >> name; 
cout << "Age?" << endl; 


int age; 

cin >> age: 

cout << "Hello " << name << " | see you have attained " << age 
<< " years. Congratulations." << endl; 


} 


A 
| Q A string is actually an object type. Inside it is just a bunch of chars! | 


Summary 


In this chapter, we spoke about variables and memory. We talked about 
mathematical operations on variables and how simple they were in C. 


We also discussed how arbitrarily complex data types can be built using a 
combination of these simpler data types, such as yoats, integers, and characters. 
Constructions such as this are called objects. 
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If, Else, and Switch 


In the previous chapter, we discussed the importance of memory and how it can 
be used to store data inside a computer. We spoke about how memory is reserved 
for your program using variables, and how we can include different types of 
information in our variables. 


In this chapter, we will talk about how to control the yow of our program and how 
we can change what code gets executed by branching the code using control yow 
statements. H ere, we'll discuss the different types of control yow, as follows: 


If statements 
How to check whether things are equal using the == operator 
Else statements 


H ow to test for inequalities (that is, how to check whether one number is 
greater or smaller than another using the operators >, >= < <= and !=) 


Using logical operators (such as not (!), and (&&), or (| | )) 
Our prst example project with Unreal Engine 
Branching in more than two ways: 

° The elseif statement 

° The switch statement 
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Dtcpej lpi 

The computer code we wrote In Chapter 2, Variables and M emory went in one 
direction: straight down. Sometimes, we might want to be able to skip parts of 
the code. We might want the code to be able to branch in morethan one direction. 
Schematically, we can represent this in the following manner: 


> 


A flowchart 





In other words, we want the option to not run certain lines of code under certain 
conditions. The preceding þgure Is called a yowchart. According to this yowchart, 
if and only if we are hungry, then we will go prepare a sandwich, eat it, and then 
go and rest on the couch. If we are not hungry, then there is no need to make a 
sandwich, so we will simply rest on the couch. 


We'll use yowcharts in this book only sometimes, but in UE4, you can even use 
yowcharts to program your game (using something called blueprints). 


This book is about C++ code, so we will always transform our 
7 yowcharts into actual C++ code in this book. 


Eqpviqnipi 'y g'Sqy 'qH{ qut'r tqi tco 


Ultimately, what we want is the code to branch in one way under certain conditions. 
Code commands that change which line of code gets executed next are called control 
yow statements. The most basic control yow statement is thei f statement. To be 
able to codei f statements, we prst need a way to check the value of a variable 


So, to start, let's introduce the == symbol, which is used to check the value of 
a variable. 
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The == operator 


In order to check whether two things are equal in C+, we need to use not one but 
two equal signs (==) one after the other, as shown here: 


int x = 5; // as you know, we use one equals sign 

int y = 4; // for assignment.. 

// but we need to use two equals signs 

// to check if variables are equal to each other 

cout << "Is x equal to y? C++ says: " << (x == y) << endl; 


If you run the preceding code, you will notice that the output is this: 


Is x equal to y? C++ says: 0 


In CH, 1 means true, and 0 means false. If you want the words true or false to 
appear instead of 1 and 0, you can usetheboo! a! pha stream manipulator in the 
cout line of code, as shown here: 


cout << "Is x equal to y? C++ says: " << boolalpha << 
(x == y) << endl; 


The == operator is a type of comparison operator. The reason why C++ uses == to 
check for equality and not just = is that we already used up the = symbol for the 
assignment operator! (see the M ore on variables section in Chapter 2, Variables and 
Memory). If we usea single = sign, C++ will assume that we want to overwrite x 
with y , not compare them. 


Coding if statements 


Now that we have the double equals sign under our belt, let's code the yowchart. 
The code for the preceding yowchart bgure Is as follows: 


bool isHungry = true; // can set this to false if not 
// hungry! 

if( isHungry == true ) // only go inside { when isHungry is true 
{ 

cout << "Preparing snack..." << endl: 

cout << "Eating .. " << endl: 
} 
cout << "Sitting on the couch.." << endl; 


} 
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y% This is the þrst time weareusingabool variable! A bool variable 
either holds the valuet r ue orthevaluef alse. 
First, we start with aboo! variable called i sHungr y and justsetittotrue. 
Then, weuseani f statement, as follows: 
if( isHungry == true ) 


The if statement acts like a guard on the block of code below it. (Remember that 
a block of code is a group of code encased within { and }.) 


is Hungry = true? 





You can only read the code between {and }ifi sHungr y==true 


You can only get at the code inside the curly braces when i sHungry == true. 
Otherwise, you will be denied access and forced to skip over that entire block 
of code. 


Wean achieve the same effect by simply writing the following line of 
code: 


y if( isHungry ) // only go here if isHungry is 
true 
This can be used as an alternative for the following: 
if( isHungry == true ) 


The reason people might usethei f( isHungry ) form isto avoid the possibility of 
making mistakes. Writingi f( isHungry = true ) by accident will seti sHungr y 
to true every timethei f statement is hit! To avoid this possibility, we can just write 
if( isHungry ) instead. Alternatively, some (wise) people use what are called 
Yoda conditions to check an if statement:i f( true == isHungry ).Thereason 
wewrite thei f statement in this way is that, if we accidentally writei f( true = 
isHungry ),this will generate a compiler error, catching the mistake. 
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Try to run this code segment to see what | mean: 


int x = 4, yag 

cout << "Is x equal to y? C++ says: " << (x = y) << endl; // bad! 
|| above line overwrote value in x with what was in y, 

// since the above line contains the assignment x = y 

// we should have used (x == y) Instead, 

cout << "x =" << X <<", y =" << y << endl; 


The following lines show the output of the preceding lines of code: 


Is x equal to y? C++ says: 5 
xX = 5, y= 


The line of code that has(x = y) overwrites the previous value of x (which was 4) 
with the value of y (which is 5). Although we were trying to check whether x equals 
y, what happened in the previous statement was that x was assigned the value of y . 


Coding else statements 


Thee! se statement is used to have our code do something in the case that thei f 
portion of the code does not run. 


For example, say we have something else that we'd like to do in case we are not 
hungry, as shown in the following code snippet: 


bool isHungry = true; 


if( isHungry ) || notice == true is implied! 
{ 
cout << "Preparing snack..." << endl: 
cout << "Eating .. " << endl; 
} 
else || we go here if isHungry is FALSE 
{ 
cout << "I'm not hungry" << endl: 
} 
cout << "Sitting on the couch.." << endl; 
} 


There are a few important things that you need to remember about thee! s e 
keyword, as follows: 


e Anelse statement must always immediately follow after ani f statement. 
You can't have any extra lines of code between the end of the if block and the 
corresponding else block. 
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e You can never go into both the if and the corresponding else blocks. 
It's always one or the other. 





The else statement is the way you will go if! s Hungry isnot equal to true 


You can think of thei f /el se statements as a guard diverting people to either the left 
or the right. Each person will either go towards the food (when i s Hungry ==t rue), or 
they will go away from the food (wheni s Hungry ==f alse). 


Testing for inequalities using other 
eqo r ctluqp’ar gtcvqtu'@'@?.'S.'$?.'cpf '#?+ 


Other logical comparisons can be easily done in C+. The >and <symbols mean 
just what they do in math. They are the greater than (>) and less than (<) symbols, 
respectively. >=has the same meaning as the Osymbol in math. <=is the C++ code 
for Ò Since there isn't a Osymbol on the keyboard, we have to write it using two 
characters in C+ ! = is how we say "not equal to" in C+ So, for example, say we 
have the following lines of code: 


int x = 9; 
int y = 7; 


We can ask the computer whether x > y orx < y as shown here: 


cout << "Is x greater than y? " << (x > y) << endl; 

cout << "Is x greater than OR EQUAL to y? " << (x >= y) << endl; 
cout << "Is x less than y? " << (x < y) << endl: 

cout << "Is x less than OR EQUAL to y? " << (x <= y) << endl; 
cout << "Is x not equal to y? " << (x != y) << endl; 
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We need the brackets around the comparisons of x and y because of 
something known as operator precedence. If we don't have the brackets, 

A C+ will get confused between the <<and <operators. It's weird and you 
will better understand this later, but you need C++ to evaluate the (x <y) 
comparison before you output the result (<<). There is an excellent table 
available for referenceathttp://en.cppreference. com w/ cpp/ 
language/operator precedence. 


Using logical operators 


Logical operators allow you to do more complex checks, rather than checking for 

a simple equality or inequality. Say, for example, the condition to gain entry into 

a special room requires the player to have both the red and green keycards. We 
want to check whether two conditions hold true at the same time. To do this type of 
complex logic statement checks, there are three additional constructs that we need to 
learn: the not (! ), and (&&), and or (| | ) operators. 


Vj g Paqv*#ar gicvwt 
The! operator is handy to reverse the value of aboo!l ean variable. Take an example 
of the following code: 


bool wearingSocks = true; 
if( !wearingSocks ) // same as if({ false == wearingSocks ) 


{ 


cout << "Get some socks on!" << endl: 
} 


else 


{ 


cout << "You already have socks" << endl : 


} 


Thei f statement here checks whether or not you are wearing socks. Then, you 
are issued a command to get some socks on. The! operator reverses the value of 
whatever isin theboo! ean variable to be the opposite value. 


We use something called a truth table to show all the possible results of using the! 
operator on aboo! ean variable, as follows: 


true false 
false true 
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So, when weari ngSocks hasthevaluetrue,! weari ngSocks hasthevaluef alse and 
vice versa. 


Exercises 


1. What do you think will bethe value of! ! weari ngSocks when the value of 
wearingSocks Istrue? 


2. Whatisthe value ofis Visible after the following codeis run? 


bool hidden = true: 
bool isVisible = !hidden; 


Solution 


1. IfwearingSocks istrue then! wearingSocks isfalse. Therefore, 
I! wearingSocks becomes true again. It's like saying | am not not hungry. 
Not not is a double negative, so this sentence means that | am actually hungry. 


2. Theanswer to the second question is false. hi dden was true, so ! hi dden Is 
false. false then gets saved into thei s Vi si bl e variable. 


The! operator is sometimes colloquially known as bang. The 
preceding bang bang operation (! ! ) isa double negative and a 

< double logical inversion. If you bang-bang aboo! variable, there is 
no net change to the variable. If you bang-bang ani nt variable, it 
becomes asimpleboo! variable(t rue orfalse).Ifthei nt valueis 
greater than zero, itis reduced to a simplet r ue. If thei nt valueisO 
already, itis reduced toasimplef alse. 


The And (&&) operator 


Say, we only want to run a section of the code if two conditions are true. For 
example, we are only dressed if we are wearing both socks and clothes. You can use 
the following code to checks this: 


bool wearingSocks = true; 

bool wearingClothes = false; 

if( wearingSocks && wearingClothes )// && requires BOTH to be true 
{ 


cout << "You are dressed!" << endl: 


} 
else 
{ 
cout << "You are not dressed yet" << endl; 
} 


egg SSS 
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The Or (||) operator 


We sometimes want to run a section of the code if eather one of the variables ist rue. 


So, for example, say the player wins a certain bonus if he pnds either a special star 
in the level or the time that he takes to complete the level is less than 60 seconds, in 
which case you can use the following code: 


bool foundStar = true: 
float level CompleteTime = 25.f; 
float maxTimeForBonus = 60.f; 
|} || requires EITHER to be true to get in the { below 
if( foundStar || level Compl eteTime < maxTi meForBonus ) 
{ 
cout << "Bonus awarded!" << endl; 
} 
else 
{ 
cout << "No bonus." << endl: 


} 


Qw'Otuvgzco r ry'y kj 'WotgcnGpi lpg 


We need to get started with Unreal Engine. 


A word of warning: when you open your prst Unreal project, you 
will pnd that the code looks very complicated. Don't get discouraged. 
< Simply focus on the highlighted parts. Throughout your career as a 
Q programmer, you will often have to deal with very large code bases 
containing sections that you do not understand. H owever, focusing on 
the parts that you do understand will make this section productive. 
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Open the Unreal Engine Launcher app (which has the blue-colored UE4 icon @). 
Select Launch Unreal Engine 4.4.3, as shown in the following screenshot: 


a wills v 
- bill sheriff@qmail.com 


Feed My Projects G 


Library _ 
Marketplace r | ry T. 





y If the Launch button is grayed out, you need to go to the Library 
Q tab and download an engine (~3 GB). 


Once the engine is launched (which might take a few seconds), you will bein 
the Unreal Project Browser screen (black-colored UE4 icon @), as shown in the 
following screenshot. 


N ow, select the New Project tab in the UE4 project browser. Scroll down until you 
reach Code Puzzle. This is one of the simpler projects that doesn't have too much 
code, so it's good to start with. We'll go to the 3D projects later. 
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AL Unreal Project Browser 


Projects New Project OELG ES 


Choose a template for your project. If you choose a C++ template, you must have Visual Studio 2013 installed to compile. 
Blueprint templates use only visual scripting, and do not require additional software. 


ae us 


A project that features a fixed overhead camera and blocks that can be clicked to change their color. 


Include starter content 


© 
REDIGE Puzzle (4) 


ROCHE Y:\Unreal Projects Choose Folder 


File Y:\Unreal Projects\APuzzle\APuzzle.uproject fe Unreal Projects 
: : ; z fm Puzzle 
A folder containing a project file (.uproject) and a few other folders will be created for you at the specified path. Ba Config 
fe Content 
BR APuzzle.uproject 





Here are a few things to make a note of in this screen: 


e Besureyou'rein the N ew Project tab 


e When you click on Code Puzzle, make sure that it is the one with the C ++ 
icon at the right, not Blueprint Puzzle 


e Enter a name for your project, Puzz!e,in the Name box (this is important for 
the example code! will give you to work on later) 


e |f you want to change the storage folder (to a different drive), click the down 
arrow so that the folder appears. Then, name the directory where you want 
to store your project. 


After you've done all this, select Create Project. 
Visual Studio 2013 will open with the code of your project. 
Press Ctrl+F5 to build and launch the project. 
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Once the project compiles and runs, you should see the Unreal Editor, as shown In 
the following screenshot: 


a 


> (eR). Al. 


Tua O O Bree 


New - import 


al 


= aE) 
ac 


| i 
m jè e 


l 





Looks complicated? Oh boy, it sure is! We'll explore some of the functionality in the 
toolbars at the side later. For now, just select Play (marked in yellow), as shown in 
the preceding screenshot. 
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This launches the game. This is how it should look: 





N ow, try clicking on the blocks. As soon as you click on a block, it turns orange, 
and this increases your score. 


What we're going to do Is pnd the section that does this and change the behavior 
a little 


Find and open thePuzz! eBlock. cpp ple 


A In Visual Studio, the list of ples in the project is located inside the 
Q Solution Explorer. If your Solution Explorer is hidden, simply click 
on View/ Solution Explorer from the menu at the top. 
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Inside this ple, scroll down to the bottom, where you'll pnd a section that begins with 
the following words: 


void APuzzleBlock:: BlockClicked(UPrimtiveComponent* ClickedComp) 


Solution Explorer 


G © 


fg. Solution ‘Puzzle’ 

4 h] puzzle 
config 

» == External Dependencies 
source 
Dal Puzzle 
Fal Private 
Puzzle.cpp 


PuzzleBlock.cpp 


b 
D 
p PuzzleBlockGrid. cpp 
b 
b 


Puzzlecame*iode. cpp 
PuzzlePlayercontroller.cpp 
sa Public 
> mg Resources 


c" Puzzle.Build.cs 





APuzzleBlock istheclass name, and BI ockCl i cked isthe function name. Whenever 
a puzzle block gets clicked on, the section of code from the starting {to the ending } 
is run. Hopefully, exactly how this happens will make more sense later. 


It's kind of like ani f statement in away. If a puzzle piece is clicked on, then this 
group of the codeis run for that puzzle piece. 


We're going to walk through the steps to make the blocks yip colors when they 
are clicked on (so, a second click will change the color of the block from orange 
back to blue). 


Perform the following steps with the utmost care: 


1. OpenPuzz!eBlock.h ple After line 25 (which has this code): 


/** Pointer to orange material used on active blocks */ 
UPROPERTY( ) 
class UMateriallnstance* OrangeMaterial; 


Insert the following code after the preceding lines of code: 


UPROPERTY( } 
class UMateriallnstance* BlueMaterial: 


2. Now, open Puzz! eBl ock. cpp ble After line 40 (which has this code): 


// Save a pointer to the orange material 
OrangeMaterial = ConstructorStatics. OrangeMaterial.Get(); 
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Insert the following code after the preceding lines: 


BlueMaterial = ConstructorStatics. BlueMaterial.Get(): 


3. Finally, inPuzz! eBl ock. cpp, reolace the contents of the voi d 
APuzzl eBl ock:: BI ockClicked section of code (line 44) with the 
following code: 


void APuzzleBlock:: BlockClicked(UPrimtiveComponent* ClickedComp) 
{ 

|| --REPLACE FROM HERE- - 

blsActive = !blsActive; // flip the value of blsActive 

// (if it was true, it becomes false, or vice versa) 

if ( blsActive ) 


{ 
BlockMesh->SetMaterial(0, OrangeMateri al); 
} 
else 
{ 
BlockMesh- >SetMaterial(0, BlueMaterial): 
} 


// Tell the Grid 
if( Owni ngGrid != NULL) 


{ 

Owni ngGrid- >AddScore(): 
} 
|| --TO HERE- - 


Only replaceinsidethevoid APuzzleBlock::BlockClicked 
sl (UPrimtiveComponent* ClickedComp) statement. 


Q Do not replace the line that starts with voi d 
APuzzleBl ock:: BlockClicked. You might get an error (if you 
haven't named your project Puzzle). You've been warned. 


So, let's analyze this. This is the prst line of code: 


blsActive = !blsActive; // flip the value of blsActive 


This line of code simply yips the value of bl sActive.bl sActive iSabool variable 
(itis created inAPuzzleBlock.h).Ifbl sActive istrue,! bl sActi ve will be false. 
So, whenever this line of code is hit (which happens with a click on any block), the 
bl sActive valueis reversed (fromt rue tof alse orfromfalse totrue). 
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Let's consider the next block of code: 
if ( blsActive ) 


{ 
BlockMesh- >SetMaterial(0, OrangeMateri al); 
} 
else 
{ 
BlockMesh- >SetMaterial(0, BlueMaterial): 
} 


Weare simply changing the block color. If b| sActi ve istrue, then the block becomes 
orange. Otherwise, the block turns blue. 


Exercise 


By now, you should notice that the best way to get better at programming is by 
doing it. You have to practice programming a lot to get signipcantly better at it. 


Create two integer variables, called x and y, and read them in from the user. 
Write ani f /el se statement pair that prints the name of the bigger-valued variable. 


Solution 
The solution of the preceding exercise is shown in the following block of code: 
int x, y; 


cout << "Enter two numbers integers, separated by a Space " << endl; 
cin >> x >> y; 


if( x <y ) 
{ 
cout << "x is less than y" << endl; 
} 
else 
{ 
cout << "x is greater than y" << endl: 
} 


al 


= Don't type a letter when ci n expects a number. ci n can fail and 
give a bad value to your variable if that happens. 
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In the previous sections, we were only able to make the code branch in one of the 
two ways. In pseudocode, we had the following code: 


if( some condition is true ) 
{ 
execute this; 
} 
else // otherwise 
{ 
execute that; 


} 


Q Pseudocode is fake code. Writing pseudocode is a great way to brainstorm 


and plan out your code, especially if you are not quite used to C. 


This code ts alittle bit like a metaphorical fork in the road, with only one of two 
directions to choose from. 


Sometimes, we might want to branch the code in more than just two directions. 
We might want the code to branch in three ways, or even more. For example, say 
the direction in which the code goes depends on what item the player is currently 
holding. The player can be holding one of three different items: a coin, key, or sand 
dollar. And C++ allows that! In fact, in C+, you can branch in any number of 
directions as you wish. 


The else if statement 


Theelse if statement is away to codein more than just two possible branch 
directions. In the following code example, the code will go in one of the three 

different ways, depending on whether the player is holding theCoin,Key,or 

Sanddollar objects: 


#include <iostream> 
using namespace std; 
int main() 
{ 
enum Item // enums define a new type of variable! 
{ 
Coin, Key, Sanddollar // variables of type Item can have 
|] any one of these 3 values 


} 
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Item item nHand = Key; // Try changing this value to Coin, 
||} Sanddollar 
if( item nHand == Key ) 
{ 
cout << "The key has a |ionshead on the handle." << endl; 
cout << "You got into a secret room using the Key!" << endl: 


else if( itemlnHand == Coin ) 


cout << "The coin is a rusted brassy color. It has a picture 
of a lady with a skirt." << endl: 


cout << "Using this coin you could buy a few things" << endl; 
else if( item nHand == Sanddollar ) 


cout << "The sanddollar has a little star on it." << endl; 
cout << "You might be able to trade it for something." << 
endl ; 

} 


return 0: 


} 


N ote that the preceding code only goes in one of the three separate 
NS ways! Inanif,else if,andelse if seriesof checks, wewill only 
i ever go into one of the blocks of code. 





Exercise 


Use C+ program to answer the questions that follow. Be sure to try these exercises 
in order to gain yuency with these equality operators. 


#include <iostream> 
using namespace std: 
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int main() 
{ 
int xX; 
int y; 
cout << "Enter an integer value for x:" << endl: 
cin >> x; // This will read in a value fromthe console 
|| The read in value will be stored in the integer 


// variable x, so the typed value better be an integer! 
cout << "Enter an integer value for y:" << endl: 


Cin >> y; 
cout << "x =" << X <<", y=" << y << endl; 
I| *** Write new lines of code here 


} 
Write some new lines of code at the spot that says (// *** Write new... ): 


1. Check whether x andy are equal. If they are equal, printx and y are 
equal . Otherwise, printx and y are not equal. 


2. An exercise on inequalities: check whether x is greater than y . If itis, 


Chapter 3 


printx is greater than y. Otherwise, printy is greater than x. 


Solution 
To evaluate equality, insert the following code: 
if( x == y ) 
{ 
cout << "x and y are equal" << endl; 
} 
else 
{ 
cout << "x and y are not equal" << endl; 
} 
To check which value Is greater insert the following code: 
if( x > y) 
{ 


cout << "x is greater than y" << endl: 


else if( x < y } 


{ 
cout << "y is greater than x" << endl: 
} 
else // in this case neither x > y nor y > x 
{ 
cout << "x and y are equal" << endl: 
} 
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The switch statement 


Thes wi t ch statement allows your code to branch in multiple ways. What the 
switch statement will do is look at the value of a variable, and depending on its 
value, the code will go in a different direction. 


We'll also introduce thee num construct here: 


#include <iostream> 
using Namespace std; 
enum Food // enums define a new type of variable! 
{ 
// a variable of type Food can have any of these values 
Fish, 
Bread, 
Apple, 
Orange 
Fi 
int main() 
{ 
Food food = Bread; // Change the food here 
Switch( food ) 
{ 
case Fish: 
cout << "Here fishy fishy fishy" << endl; 
break; 
case Bread: 
cout << "Chomp! Delicious bread!" << endl; 
break; 
case Apple: 
cout << "Mm fruits are good for you" << endl: 
break; 
case Orange: 
cout << "Orange you glad | didn't say banana" << endl; 
break; 
default: // This is where you go in case none 
// of the cases above caught 
cout << "Invalid food" << endl; 
break; 
} 
return Q0; 


} 
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Switches are like coin sorters. When you drop 25 cent into the coin sorter, it pnds its 
way into the 25 cent pile. Similarly, as wi t ch statement will simply allow the code to 
jump down to the appropriate section. The example of sorting the coins is shown in 
the following bgure: 




















The code inside thes wi tch statement will continue to run (line by line) until the 
break; Statement is hit. Thebr eak statement jumps you out of thes wi t ch statement. 
Take a look at the following diagram to understand how the switch works: 


Food food = Fish; // Change the food here 
(1) switch( food ) 
{ ~ 
(2)case Fish: 
5 (3)cout << “Here fishy fishy fishy" << endl; 
(4) break; 
case Bread: 
cout << “Chomp! Delicious bread!" << endl; 
break; 


cout << “End of switch" << endl; 





l. First, theFood variable is inspected. What value does it have? In this case, 
it hasFish inside it. 


2. Theswitch command jumps down to the correct case label. (If there is no 
matching case label, the switch will just be skipped). 
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3. Thecout statementisrun, andHere fishy fishy fishy appears on 
the console. 


4. After inspecting the variable and printing the user response, the break 
statement is hit. This makes us stop running lines of code in the switch and 
exit the switch. The next line of code that Is run is just what would otherwise 
have been the next line of codein the program if the switch had not been 
there at all (after the closing curly brace of the switch statement). It is the 
print statement at the bottom, which says "End of switch". 


Switch versus if 


Switches arelikethei f / else if / else chains from earlier. However, switches can 
generate code faster thani f / else if / else if / else chains. Intuitively, switches 
only jump to the appropriate section of the code to execute. If / edseif / esechains 
might involve more complicated comparisons (including logical comparisons), which 
might take more CPU time. The main reason you will usethei f statements is to do 
more with your own custom comparisons inside the brackets. 


An enum is really an int. To verify this, print the following code: 


al cout << "Fish=" << Fish << 
= " Bread=" << Bread << 
" Apple=" << Apple << 
" Orange=" << Orange << endl; 
You will see the integer values of the enumn just so you know. 


Sometimes, programmers want to group multiple values under the same switch 
case label. Say, wehavean enum, object as follows: 


enum Vegetables { Potato, Cabbage, Broccoli, Zucchini }; 


A programmer wants to group all the greens together, so he writes as wi tch 
Statement as follows: 


Switch( veg ) 


{ 
case Zucchini: || zucchini falls through because no break 
case Broccoli: // was written here 
cout << "Greens!" << endl; 
break; 
default: 
cout << "Not greens!" << endl; 
break; 
} 
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In this case, Zucchini falls through and executes the same code as Broccoli. 
The non-green vegetables arein thedef aul t caselabel. To prevent a fall through, 
you have to remember to insert an explicitbreak statement after each case label. 


Wecan write another version of the same switch that does not let Zucchini fall 
through, by the explicit use of the keyword break in the switch: 


Switch( veg ) 


{ 
case Zucchini: || zucchini no longer falls due to break 
cout << "Zucchini is a green" << endl: 
break:// stops case zucchini from falling through 
case Broccoli: || was written here 
cout << "Broccoli is a green" << endl: 
break; 
default: 
cout << "Not greens!" << endl; 
break; 


} 


N ote that it is good programming practiceto break thedef aul t caseas well, even 
though it is thelastcase listed. 


Exercise 

Complete the following program, which has an enum object with a series of mounts 
to choose from. Write as wi tch statement that prints the following messages for the 
mount selected: 


The steed is valiant and mighty 
This mare is white and beautiful 


You are given a mule to ride. You resent that. 
Sheep Baa! The sheep can barely support your weight. 


Remember, an enum object is really ani nt statement. The prst entry in an enum object 
is by default 0, but you can give theenum object any starting value you wish using 
the =operator. Subsequent values in theenum object arei nts arranged in order. 
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Bit-shifted enum 
A common thing to do in ane n u m object is to assign a bit-shifted value 
to each entry: 
enum Wi ndowProperties 
{ 
Bordered = 1 << 0, // binary 001 
Transparent = 1 << 1, // binary 010 
Modal = 1 << 2 // binary 100 
ie 


The bit-shifted values should be able to combine the window properties. 
~ This is how the assignment will look: 
Q // bitwise OR combines properties 


WindowProperties wp = Bordered | Modal: 
Checking which Wi ndowProperties have been set involves a check 
usingbi twise AND: 

// bitwise AND checks to see if wp is Modal 

if( wo & Modal ) 

{ 
cout <<"You are looking at a modal window" <<endl; 

} 


Bit shifting is a technique that is slightly beyond the scope of this text, 
but I've included this tip just so you Know about it. 


Solution 
The solution of the preceding exercise is shown in the following code: 


#include <iostream> 
using namespace std; 
enum Mount 
{ 
Horse=l, Mare, Mule, Sheep, Chocobo 
|| Since Horse=l, Mare=2, Mule=3, Sheep=4, and Chocobos5. 
J 
int main() 
{ 
int mount; // We'll use an int variable for mount 
I} so cin works 


$$ 


www.it-ebooks.info 


Chapter 3 


cout << "Choose your mount:" << endl; 
cout << Horse << " Horse" << endl: 
cout << Mare << " Mare" << endl: 
cout << Mule << " Mule" << endl: 
cout << Sheep << " Sheep" << endl; 
cout << Chocobo << " Chocobo" << endl; 
cout << "Enter a number from 1 to 5 to choose a mount" << endl; 
cin >> mount; 
// Write your switch here. Describe what happens 
|| when you mount each animal in the switch below 
Switch( mount ) 
{ 
default: 
cout << "Invalid mount" << endl; 
break; 
} 
return 0; 


} 


Summary 


In this chapter, you learned how to branch the code. Branching makes it possible for 
the code to go in a different direction instead of going straight down. 


In the next chapter, we will move on to a different kind of control yow statement 
that will allow you to go back and repeat a line of code a certain number of times. 
The sections of code that repeat will be called loops. 
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Looping 


In the previous chapter, we discussed thei f statement. Thei f statement enables 
you to put a condition on the execution of a block of code. 


In this chapter, we will explore loops, which are code structures that enable you to 
repeat a block of code under certain conditions. We stop repeating that block of code 
once the condition becomes false. 


In this chapter, we will explore the following topics: 


e Whileloops 

e Do/ whileloops 

e For loops 

e A simple example of a practical loop within Unreal Engine 


The while loop 


Thewhi | e loop is used to run a section of the code repeatedly. This is useful if 
you havea set of actions that must be done repeatedly to accomplish some goal. 
For example, thewhi | e loop in the following code repeatedly prints the value of 
the variablex as itis incremented from 1 to 5: 


int x = 1; 
while( x <= 5 ) // may only enter the body of the while when x<=5 
{ 
cout << "x is " << x << endl: 
X++; 
} 


cout << "Finished" << endl; 
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This ts the output of the preceding program: 
Xis l 
x 1S 2 
Xx 1S 3 
x 1s 4 
x 1s 5 
Finished 


In the þrst line of code, an integer variablex is created and set to 1. Then, we go the 
whi | e condition. Thewhi | e condition says that whilex is less than or equal to 5, you 
must stay in the block of code that follows. 


Each iteration of the loop (an iteration means going once around the loop) gets a little 
more done from the task (of printing the numbers 1 to 5). We program the loop to 
automatically exit once the task is done (when x <= 5 is no longer true). 


Similar to thei f statement of the previous chapter, entry into the block below the 
while loop is only allowed if you meet the condition within the brackets of the whi | e 
loop (in the preceding example, x <= 5). You can try mentally subbing ani f loop in 
the place of the whi | e loop, as shown in the following code: 


int x = 1; 
if( x <= 5 ) // you may only enter the block below when x<=5 
{ 
cout << "x is " << x << endl: 
X++; 
} 


cout << "End of program" << endl; 


The preceding code sample will only printx is 1.S0, awhile loop is exactly like an 
i f statement, only it has this special property of automatically repeating itself until 
the condition between the brackets of thewhi | e loop becomesf alse. 


I'd like to explain the repetition of thewhi | e loop using a video 


game. If you don't know Valve's P ortal, you should play it, if only 
J to understand loops. Check outhttps://www. youtube. com/ 


watch?v=Tl uRVBhmf 8w for a demo video. 
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Thewhi | e loops havea kind of magic portal at the bottom, which cause the loop to 
repeat. The following screenshot illustrates what | mean: 


while( x <= 5 ) 


{ 


cout << "xis" << x << endl; 


K++: 





There is a portal at the end of the while loop that takes you back to the beginning 


In the preceding screenshot, we loop back from the orange portal (marked O ) to 
the blue portal (marked B). This is our þrst time of being able to go back in the code. 
Itis liketime trava, only for the code. How exciting! 


The only way past awhi | e loop block is to not meet the entry condition. In the 
preceding example, once the value of x becomes 6 (So, x <= 5 becomes false), we 
will not enter thewhi | e loop again. Since the orange portal is inside the loop, we'll 
be able to get to bnished oncex becomes 6. 


Oph reqr u 
You can get stuck inside the same loop forever. Consider the modibed program in 
the following block of code (what do you think will be the output?): 


int x = 1; 
while( x <= 5 ) // may only enter the body of the while when x<=5 


{ 
} 


cout << "End of program" << endl; 


cout << “x 15 * << X << ndl: 


This is how the output will look: 
x is l 
x is 1l 
x is 1l 


(repeats forever) 
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The loop repeats forever because we removed the line of code that changed the value 
of x . If the value of x stays the same and is not allowed to increase, we will be stuck 
inside the body of thewhi | e loop. This is because the loop's exit condition (the value 
of x becomes 6) cannot be met if x does not change inside the loop body. 


The following exercises will use all the concepts from the previous chapters, such as 
the += and decrement operations. If you've forgotten something, go back and reread 
the previous sections. 


Exercises 


1. Writeawhi! e loop that will print the numbers from 1 to 10. 
2. Writeawhi |e loop that will print the numbers from 10 to 1 (backwards). 


3. Writeawhi | e loop that will print numbers 2 to 20, incrementing by 2 (for 
example 2, 4, 6, and 8). 


4. Writeawhi | e loop that will print the numbers 1 to 16 and their squares 
beside them. 


The following is an example program output of the exercise 4: 





Solutions 


The code solutions of the preceding exercises are as follows: 


1. Thesolution of thewhi | e loop that prints the numbers from 1 to 10 is 
as follows: 
int x = 1; 
while( x <= 10 ) 
{ 


cout << x << endl: 
X++; 
} 


['96'] 


www.it-ebooks.info 


Chapter 4 


2. Thesolution of thewhi | e loop that prints the numbers from 10 to 1 in 
backwards is as follows: 
int x = 10; // start x high 
while( x >= 1) // go until x becomes 0 or less 
{ 
cout << x << endl; 
x--; // take x down by 1 
} 


3. The solution of thewhi | e loop that prints the numbers from 2 to 20 
incrementing by 2 is as follows: 
int x = 2: 
while( x <= 20 ) 
{ 
cout << x << endl: 
xt=2; // increase x by 2's 


} 


4. Thesolution of thewhi | e loop that prints the numbers from 1 to 16 with their 
squares is as follows: 


int x = 1; 

while( x <= 16 ) 

{ 
cout << x << '" " << x*¥x << endl; // print x and it's 
Square 
X++; 

} 


The do/while loop 


Thedo/ whi! e loop is almost identical to thewhi | e loop. Here's an example 
of ado/ whi | e loop that is equivalent to the prst whi | e loop that we examined: 


int x= 1; 

do 

{ 
cout << "x is " << x << endl; 
X++; 


} while( x <= 5 ); // may only loop back when x<=5 
cout << "End of program" << endl; 
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The only difference here is that we don't have to check thewhi | e condition on 

our þrst entry into the loop. This means that thedo/ whi | e loop's body is always 
executed at least once (where awhi | e loop can be skipped entirely if the condition 
to enter thewhi | e loop isf al se when you hit it for the prst time). 


The for loop 


Thef or loop has a slightly different anatomy than thewhi | e loop, but both are 
very similar. 


Let's examine the anatomy of af or loop as compared to an equivalent whi | e loop. 
Take an example of the following code snippets: 


The for loop An equivalent while loop 


fort int x ! ! int x 
{ while( x <= 5 ) 


cout << x << endl: { 
} cout << x << endl: 
XT; 
} 





Thef or loop has three statements inside its brackets. Let's examine them in order. 


The prst statement of thef or loop (i nt x = 1;) only gets executed once, when 

we prst enter the body of thef or loop. It is typically used to initialize the value 

of the loop's counter variable (in this case, the variable x ). The second statement 
inside thef or loop (x <= 5;)istheloop's repeat condition. ASlong asx <= 5,we 
must continue to stay insidethe body of thef or loop. Thelast statement inside the 
brackets of thef or loop (x ++;) gets executed after we complete the body of thef or 
loop each time. 
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The following sequence of diagrams explain the progression of thef or loop: 


happens only once, on Then we check the condition to see if we 
first time we hit for loop are allowed into the body of the for loop 





for( int x = 1; x <= 5; X++ ) for( int x = 1; x <= 5; x++ ) 
{ { 


cout << x << endl; cout << x << endl: 


} 1 | + 


Assuming we're allowed into the body, After execution of all the lines of code, 
we execute all the lines of code inside we hit the 3rd statement of the for loop 
for( int x = 1: x <= 5; x++ ) for( int x = 1; x <= 5; x++ ) 
{ 
cout << x << endl: cout << x << endl; 
3 } 


We then go back and check the loop If so, we enter the body of the loop again, 
condition. Are we going to be allowed and the loop continues (until x exceeds 5) 
into the body of the for again? 


forl intx = LI x <É 5:\xt+ ) for( int x = 1; x <= 5; X++) 
{ 


} 


cout << x << endl; cout << x << endl; 


Exercises 
1. Writeafor loop that will gather the sum of the numbers from 1 to 10. 
2. Writeafor loop that will print the multiples of 6, from 6 to 30 (6, 12, 18, 24, 
and 30). 
3. Writeafor loop that will print numbers 2 to 100 in multiples of 2 
(for example, 2, 4, 6, 8, and so on). 
4. Writeafor loop that will print numbers 1 to 16 and their squares 


beside them. 
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Solutions 
H ere are the solutions for the preceding exercises: 


1. Thesolution for thef or loop for printing the sum of the numbers from 1 to 
10 is as follows: 


int sum = 0; 
for( int x = 1; x <= 10; x+) 
{ 
Sum += X; 
cout << x << endl: 
} 


2. Thesolution for thef or loop for printing multiples of 6 from 30 is as follows: 


for( int x = bs x <= 30% x += 6 ) 
{ 


cout << x << endl: 


} 


3. Thesolution for thef or loop for printing numbers from 2 to 100 in multiples 
of 2 is as follows: 
for( int x = 2) x <= 100; x += 2} 
{ 


cout << x << endl: 


} 


4. Thesolution for thef or loop that prints numbers from 1 to 16 and their 
squares is as follows: 


for( int x = 1: x <= 16: x+ł ) 
{ 


cout << x << " " << x*x << endl: 


} 


Looping with Unreal Engine 


In your code editor, open your Unreal Puzzle project from Chapter 3, If, Else 
and Switch. 
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There are several ways to open your Unreal project. The simplest way is probably to 
navigate to the Unreal Proj ects folder (which is present in your user's Document s 
folder on Windows by default) and double-click on the. s! n plein Windows 
Explorer, as shown in the following screenshot: 


di Binaries (25/2014 5:56 Ai File folder 
di config (25/2014 5:56 A&i File folder 
di content (25/2014 5:56 Ai File folder 
di Intermediate f27/201- 4, File folder 
|) saved (25/2014 5:56 A! File folder 
di Source (25/2014 5:56 4% File folder 
Puzzle. opens df f27/201- ‘| OPENSDF File a KB 


|_| Puzzle. sdf {27/201 a, SDF File 45,023 KB 


fee] puzzle.sJn 9/24/2014 18:81 A Microsoft vista... 


qty Puzzle. uproaject 9/24/2014 16:91 & Unreal Engine P... 


Puzzle. vl2.suea 3/27/2014 8:427 Api Visual Studia 5... 





On Windows, open the .sln file to edit the project code 


Now, open thePuzzleBlockGrid.cpp ple Inside this ple, scroll down to the section 
that begins with the following statement: 


void APuzzleBlockGrid::BeginPl ay() 


Notice that there is af or loop here to spawn the initial nine blocks, as shown in the 
following code: 


|| Loop to spawn each block 
for( int32 Blockl ndex=0; Blockl ndex < NumBlocks; Blockl ndex++ ) 
{ 
Ps 
} 


Since NumBl ocks (which is used to determine when to stop the loop) gets computed as 
Si ze*Si ze, wecan easily change the number of blocks that get spawned by altering 
the value of thesSi ze variable. Go to line 23 of Puzz! eBl ockGrid. cpp and changethe 
value of theSi ze variableto four or pve. Then, run the code again. 
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You should see the number of blocks on the screen increase, as shown in the 
following screenshot: 





Setting the size to 14 creates many more blocks 


Summary 


In this chapter, you learned how to repeat lines of code by looping the code, which 
allowed you to go back into it. This can be used to repeatedly use the same line of 
code in order to achieve a task. Imagine printing the numbers from 1 to 10 without 
using aloop. 


In the next chapter, we will explore functions, which are the basic units of 
reusable code. 
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Functions 


Some things needs to be repeated. Code is not one of them. A function is a bundle 
of code that can get called any number of times, as often you wish. 


Analogies are good. Let's explore an analogy that deals with waiters, chefs, pizzas, 
and functions. In English, when wesay a person has a function, we mean that the 
person performs some very specifc (usually, very important) task. They can do this 
task again and again and whenever they are called upon to do so. 


The following comic strip shows the interaction between a waiter (caller) and a chef 
(callee). The waiter wants food for his table, so he calls upon the chef to prepare the 
food required by the waiting table. 
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The chef prepares the food and then returns the result to the waiter. 


3 pepperoni pan 
pizzas, pronto 





3 pan pizzas 3 pepperoni pan 
coming right up pizzas, pronto 


Thanks, Chef- 
dude 





Here, the chef performs his function of cooking food. The chef accepted the parameters 
about what type of food to cook (three pepperoni pan pizzas). The chef then went 
away, did some work, and returned with three pizzas. N ote that the waiter does not 
know and does not care about how the chef goes about cooking the pizzas. The chef 
abstracts away the process of cooking pizzas for the waiter, so cooking a pizza is just 

a simple, single-line command for the waiter. The waiter just wants his request to be 
completed and the pizzas returned to him. 


When a function (chef) gets called with some arguments (types of pizzas to be 
prepared), the function performs some actions (preparing the pizzas) and optionally 
returns a result (the actual þnished pizzas). 


[4] 


www.it-ebooks.info 


Chapter 5 
An example of a <cmath> library function 
— sqrt() 


N ow, let's talk about a more practical example and relate it to the pizza example. 


Thereis afunction in the <c mat h> library called thes grt () function. Let me quickly 
illustrate its use, as shown in the following code: 


#include <iostream> 

#include <cmath> 

using namespace std; 

int main() 

{ 
double rootOf5 = sqrt( 5 ); // function call to the sqrt 
function 
cout << rootOf5 << endl; 


} 


So,sqrt() can pnd the mathematical square root of any number given to it. 


Do you know how to pnd the square root of a tough number such as 5? It's not 
simple. A clever soul sat down and wrote a function that can pnd the square roots 

of all types of numbers. Do you have to understand the math behind how the square 
root of 5is found to usethes qr t (5) function call? Heck, no! So, just as the waiter 
didn't have to understand how to cook a pizza in order to get a pizza as the result, 
the caller of aC ++ library function does not have to fully understand how that 
library function works internally to use it effectively. 


The following are the advantages of using functions: 


1. Functions abstract away a complex task into a simple, callable routine. 
This makes the code required to cook a pizza, for instance, just a single-line 
command for the caller (the caller is typically your program). 


2. Functions avoid the repetition of code where it is not necessary. Say we 
have 20 or so lines of code that can pnd the square root of a double value. 
We wrap these lines of code into a callable function; instead of repeatedly 
copying and pasting these 20 lines of code, we simply call thes qrt function 
(with the number to root) function whenever we need a root. 
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The following illustration shows the process of pnding a square root: 


I need to find sqrt (5). 


I don't care what ittakes 
just get me the result. 


i 


Í 100101000010101 
| 100010100101010 
| 101001lots100f001 
| 10101010work100 





Writing our own functions 


Say, we want to write some code that prints out a strip of road, as shown here: 


cout << "* *" << endl; 
cout << "* | *#" << endl; 
cout << "* | *" << endl; 
cout << "* *" << endl; 


[ie] 
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Now, say we want to print two strips of road, in a row, or three strips of road. Or, say 
we want to print any number of strips of road. We will have to repeat the four lines of 
code that produce the prst strip of road once per strip of road we're trying to print. 


What if we introduced our own C++ command that allowed us to print a strip of 
road on being called the command. Here's how that will look: 


void printRoad{ ) 
{ 


cout << "* ee. e< Oia: 
cout << "* | *" << endl: 
cout << "* | *" << endl: 
cout << "* *" << endl; 


} 


This ts the depnition of a function. A C+ function has the following anatomy: 


function name 


void |printRoad{ ) 


cout << 
cout << 
cout << 
cout << 





Using a function is simple: we simply invoke the function we want to execute by 
name, followed by two round brackets (). For example, calling thepri nt Road() 
function will cause thepri nt Road() function to run. Let's trace an example program 
to fully understand what this means. 


A sample program trace 

Here's a complete example of how a function call works: 
#include <iostream> 
using namespace std: 


void printRoad() 
{ 
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cout << "* *" << endl; 
cout << "* | *" << endl: 
cout << "* | *" << endl: 
cout << "* *" << endl; 
} 
int main() 
{ 
cout << "Program begin!" << endl: 
printRoad(); 
cout << "Program end" << endl ; 
return Q0; 


} 
Let's trace the program's execution from beginning to end. Remember that for all 
C++ programs, execution begins on the prst line of mai n() . 


mai n() ts alsoafunction. It oversees the execution of the whole 
NS program. Oncemain() executes ther et urn statement, your 
program ends. 


When the last line of the mai n() function is reached, the program ends. 


A line-by-line trace of the execution of the preceding program is shown as follows: 


void printRoad( }) 
{ 


cout << "* rE cee endi; // 3: then we jump up here 
cout << "* | *" << endl; // 4: run this 
cout << "* | *" << endl; I} 5: and this 
colr << T4 x" << endl; I} 6: and this 

} 

int main() 

{ 
cout << "Program begin!" << endl; // 1: first line to execute 
printRoad(); // 2: second line.. 
cout << "Program end" << endl: // 7: finally, last line 
return 0; // 8: and return to o/s 

} 


This ts how the output of this program will look: 


Program begin! 
* * 


* | * 
* | * 
* * 


Program end 
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Here's an explanation of the preceding code, line by line: 


1. The program's execution begins on the prst line of mai n() , which outputs 
program begin!. 


2. Thenextline of code that is run is the call to pri nt Road() . What this does is 
it jumps the program counter to the prst line of print Road().All the lines of 
print Road() then execute in order (steps 3-6). 


3. Finally, after the function call topri nt Road() is complete, control returns to 
themain() statement. Wethen seeProgram end printed. 


Don't forget the brackets after the function call topri nt Road(). 


A function call must always be followed by round brackets (), 
7 otherwise the function call will not work and you will get a 
compiler error. 


The following code Is used to print four strips of road: 


int main() 

{ 
printRoad(); 
printRoad(); 
printRoad(); 
printRoad(); 

} 


Alternatively, you can also use the following code: 


for{ int | = 0; | < 4; [++ ) 

printRoad(); 
So, instead of repeating the four lines of cout every time a box is printed, we 
simply call thepri nt Road() function to makeit print. Also, if we want to change 


how a printed road looks, we have to simply modify the implementation of the 
printRoad() function. 


Calling a function entails running the entire body of that function, line by line. After 
the function call is complete, the control of the program then resumes at the point of 
the function call. 
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Exercise 
Asan exercise, pnd out what is wrong with the following code: 
#include <iostream> 


using namespace std; 
void myFunction() 


{ 
cout << "You called?" << endl; 

} 

int main() 

{ 
cout << "I'm going to call myFunction now." << endl; 
myFunction; 

} 

Solution 


The correct answer to this problem is that the call to my Function (in the last line 
of mai n() ) isnot followed by round brackets. All function calls must be followed 
by round brackets. The last line of mai n() should read my Functi on(); , not just 

myFunction. 


Functions with arguments 


How can weextend thepri nt Road() function to print aroad with acertain number 
of segments? The answer is simple. We can let thepri nt Road() function accept a 
parameter, called numSeg ments, to print a certain number of road segments. 


The following code snippet shows how that will look: 


void printRoad(int numSegments) 


{ 
|| use a for loop to print numSegments road segments 
for( int | = 0; | < numSegments; i++) 
{ 
cout << "* *" << endl; 
cout << "* | *" << endl: 
cout << "* | *" << endl: 
cout << "* *" << endl; 
} 
} 


i 
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The following screenshot shows the anatomy of a function that accepts an argument: 


parameter 


void printRoad int ram) 


{ 





Call this new version of pri nt Road() , asking it to print four segments, as follows: 


printRoad( 4 ); |] function call 


The 4 between the brackets of thef unction call inthe preceding statement 
gets assigned to thenumSegments variableof theprintRoad(int numSegments) 
function. This is how the value 4 gets passed tonumSegments: 


The assignment of 
4,  numSegments 

happensat function 

invokation time 


void printRoad(int numSegments ) 


{ 


An illustration of how printRoad(4) will assign the value 4 to the numSegments variable 





So, numSegments gets assigned the value passed between the brackets in the call 
toprintRoad(). 


Functions that return values 


An example of a function that returns a value is thes qrt() function. Thes qr t () 
function accepts a single parameter between its brackets (the number to root) and 
returns the actual root of the number. 


Here's an example usage of thes gr t function: 
cout << sqrt( 4 ) << endl; 


Thes grt () function does something analogous to what the chef did when preparing 
the pizzas. 


As a caller of the function, you do not care about what goes on inside the body of the 
sqrt () function; that information is irrelevant since all you want is the result of the 
square root of the number that you are passing. 
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Let's declare our own simple function that returns a value, as shown in the 
following code: 


int sumiint a, int b) 
{ 


return a + b; 


} 


The following screenshot shows the anatomy of a function with parameters 
and areturned value: 


return type parameters 


Fant sum([int a, int b ) 


{ 


return a + b; 





Thes um function is very basic. All it does is taketwoi nt numbersa and b, sums 
them up together, and returns a result. You might say that we don't even need 

an entire function just to add two numbers. You're right, but bear with me for a 
moment. We will use this simple function to explain the concept of returned values. 


You will use thes um function in this way (from mai n() ): 


int sum int a, int b ) 
{ 
return a + b; 
} 
int main() 
{ 
cout << "The sum of 5 and 6 is " << sum 5,6) << endl: 


} 


For thecout command to complete, thesum( 5,6 ) function call must be evaluated. 
Atthe point wherethesum( 5,6 ) function call occurs, the returned value from 
sum 5,6 ) is put right there. 
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In other words, this is the line of codethatcout actually sees after evaluating the 
sum 5,6 ) function call: 


cout << "The sum of 5 and 615 " << 11 << endl: 


The returned valuefromsum( 5,6 ) is effectively cut and pasted at the point of the 
function call. 


A value must always be returned by a function that promises to do so (if the return 
type of the function is anything other than voi d). 


Exercises 


1. Writeani s Positive function that returnst rue when the double parameter 
passed to it is indeed positive. 


2. Complete the following function depnition: 


|| function returns true when the magnitude of 'a' 
// is equal to the magnitude of 'b' (absolute value) 
bool absEqual(int a, int b) 
{ 

|| to complete this exercise, try to not use 

// cmath library functions 


} 


3. Writeaget Grade() function that accepts an integer value (marks out of 100) 
and returns the grade (either A, B, C, D, or F). 


4. A mathematical function is of theformf(x) = 3x + 4.WriteaC++function 
that returns values for f (x). 


Solutions 
1. TheisPositive function accepts a double parameter and returns 
a boolean value: 
bool isPositive( double value ) 


{ 


return value > 0: 


} 


2. Thefollowing is the completed abs Equa! function: 


bool absEqual( int a, int b ) 


{ 
|| Make a and b positive 
if( a <0) 
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3. 


4. 


a = -a: 
if( b <0 ) 

b = -b; 
|| now since they're both +ve, 
// we just have to compare equality of a and b together 
return a == 


} 


Theget Grade() function is given in the following code: 
char getGrade( int grade ) 


{ 
if( grade >= 80 ) 
return ‘A’; 
else if( grade >= 70 ) 
return 'B'; 
else if( grade >= 60 ) 
return “C 
else if( grade >= 50 ) 
return 'D'; 
else 
return 'F'; 
} 


This program is a simple one that should entertain you. The origin of 
thename function in C++ actually came from the math world, as shown 
in the following code: 

double f( double x ) 

{ 


return 3%*xX + 4; 


} 


Xcticdrgu. 'tgxlukof 


It's always nice to revisit a topic you've covered before, now that you understand 
C++ coding much more in depth. 


Global variables 


Now that we've introduced the concept of functions, the concept of a global variable 
can be introduced. 
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What is a global variable? A global variable is any variable that is made accessible to 
all the functions of the program. How can we make a variable that is accessible to all 
the functions of the program? We simply declare the global variable at the top of the 
code ble, usually after or near the #i nc! ude statements. 


Here's an example program with some global variables: 


#include <iostream> 
#include <string> 
using namespace std; 


string g_string; // global string variable, 

|| accessible to all functions within the program 

// (because it is declared before any of the functions 
|| below!) 


void addA(){ g_ string += "A"; } 
void addB(){ g_ string += "B"; } 
void addC(){ g_ string += "C"; } 


int main() 
{ 
addA(); 
addB(); 
cout << g string << endl; 
addC() 
cout << g string << endl; 


} 


Here, thesameg_ string global variable is accessible to all the four functions in 
the program (addA(),addB(),addC(), and mai n() ). Global variables live for the 
duration of the program. 


A! People sometimes prefer to preþx global variables with g _ , but 
Q preþxing the variable name with g_ is not a requirement for a 
variable to be global. 


Local variables 


A local variable is a variable that is deoned within a block of code. Local variables go 
out of the scope at the end of the block in which they are declared. Some examples 
will follow in the next section, The scope of a variable. 
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The scope of a variable 


The scope of a variable is the area of code where that variable can be used. The scope 
of any variable is basically the block in which it is deoned. We can demonstrate a 
variable's scope using an example, as shown in the following code: 


int g_int; // global int, has scope until end of file 
void func( int arg ) 
{ 
int fx; 
} IL </fx> dies, </arg> dies 


int main() 
{ 
int x; // variable <x> has scope starting here.. 
// until the end of mai n() 
if( x Se 04 
{ 


int y; // variable <y> has scope starting here, 
// until closing brace below 
} II </y> dies 
if( int x2 =x ) // variable <x2> created and set equal to <x> 


// enter here if x2 was nonzero 
} I|} </x2> dies 


for( int c = 0; c < 5; c++) // c is created and has 
{ // scope inside the curly braces of the for loop 
cout << c << endl: 
} I} </c> dies only when we exit the loop 
} [| </x> dies 


The main thing that depnes a variable's scope Is a block. Let's discuss the scope 
of a couple of the variables depned in the preceding code example: 


e g int: Thisisaglobal integer with a scope that ranges from the point it 
was declared until the end of the code ple. That is to say, g_i nt can be used 
insidef unc() and mai n() , but it cannot be used in other code ples. To havea 
single global variable that is used across multiple code ples, you will need an 
external variable. 


e arg (the argument off unc() ): This can be used from the prst line of f unc ( ) 
(after the opening curly brace {) to the last line of f unc() (until the closing 
curly brace }). 
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e fx:This can beused anywhere insidef unc() until the closing curly brace 
off unc() } 


e main() (variables insidemai n() ): This can be used as marked in the 
comments. 


Notice how variables declared inside the brackets of a function's argument list can 
only be used inside the block below that function's declaration. For example, the ar g 
variable passed tof unc(): 


void func( int arg ) 
{ 
int fx; 
} IL </fx> dies, </arg> dies 


Thear g variable will die after the closing curly brace (} ) of thef unc() function. This 
is counterintuitive as the round brackets are technically outside the curly braces that 
depnethe{ block}. 


The same goes for variables declared inside the round brackets of af or loop. Take as 
an example the following f or loop: 


for’ iit © =o g < 5° cee | 
{ 

cout << c << endl: 
} //] c dies here 


Thei nt c variable can be used inside the round brackets of thef or loop declaration 
or inside the block below thef or loop declaration. Thec variable will die after the 
closing of the curly brace of thef or loop itis declared in. If you want thec variable 
to live on after the brace brackets of thef or loop, you need to declarethec variable 
before thef or loop, as shown here: 


int c; 
for( c = 0; c < 5; c+t ) 
{ 
cout << c << endl; 
} // c does not die here 
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Static local variables 


Thest atic local variables are exactly like global variables, only they have a local 
scope, as shown in the following code: 


void test Func() 


{ 


Static int runCount = 0; // this only runs ONCE, even on 

|| subsequent calls to testFunc()! 

cout << "Ran this function " << ++runCount << " times" << endl; 
} // runCount stops being in scope, but does not die here 


int main() 


{ 
testFunc(); 44 says 1 time 
testFunc(); // says 2 times! 


} 


With the use of thest ati c keyword insidetestFunc(),therunCount variable 
remembers its value between calls of test Func() . So, the output of the two separate 
preceding runs of test Func() Is: 


Ran this function 1 times 
Ran this function 2 times 


That's because static variables are only created and initialized once (the prst time 
when the function they are declared in runs), and after that, the static variable retains 
its old value. Say, we declarer unCount asa regular, local, nonstatic variable: 


int runCount = 0; // if declared this way, runCount is local 
Then, this is how the output will look: 


Ran this function 1 times 
Ran this function 1 times 


Here, weseetest Func sayingRan this function 1 time both thetimes. 
Asalocal variable the value of runCount isnot retained between function calls. 


You should not overuse static local variables. In general, you should only use a static 
local variable when it is absolutely necessary. 
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Const variables 


A const variableis a variable whose value you promise the compiler not to change 
after the prst initialization. We can declare one simply, for example, for the value 
of pi: 

const double pi = 3.14159; 


Sincepi isa universal constant (one of the few things you can rely on to be the 
Same), there should be no need to changepi after initialization. In fact, changes to pi 
should be forbidden by the compiler. Try, for example, to assign pi anew value: 


pi *= 2: 
We will get the following compiler error: 


error C3892: ‘pi' : you cannot assign to a variable that is const 


This error makes perfect sense, because besides the initial initialization, we should 
not be able to change the value of pi — a variable that is constant. 


Function prototypes 


A function prototype Is the signature of the function without the body. For example, 
let's prototypethei sPositive,absEqual , and get Grade functions from the 
following exercises: 


bool isPositive( double value ); 
bool absEqual( int a, int b ); 
char getGrade( int grade }; 


N otice how the function prototypes are just the return type, function name, and 
argument list that the function requires. Function prototypes don't get a body. 
The body of the function is typically putin the. cpp ple. 


d ‘cpf ‘err ‘Ogu 
It is typical to put your function prototypes in an. h ple and the bodies of the 
functions ina.cpp ple The reason for this is you can include your. h pleina 


bunch of. cpp ples and not get multiple depnition errors. 
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The following screenshot gives you a clear pictureof.h and. cpp ples:. 


CO prototypesh YX funcs.cpp 


vi *main() (Global Scope) Y v (Global Scope) ¥ “isPositive(double value) 


#inc lude <iostream> 
) using namespace std; 
3 
4. #include “prototypes,.h" 


bF int main() 
1 4 
z cout << boolalpha 
<< lisPositive( 4 ) 

<< endl; 


J 


inc lud 


| bool isPositive( double value 
/ bool absEqual{ int a, int b ); 
& char getGrade( int grade ); 

gi 


a tendil 


I[J // Make sure these prototypes 4 


2) // only included in compilatio 
‘#itndet PROTOTYPES H // 


‘ #define PROTOTYPES H 


|j#include “prototypes.h" 


‘bool isPositive({ double value ) 


return value > @; 


bool absFqual({ int a, int b ) 


// Make a and b positive 


cout 1} if(a<@) 
<< abstqual({ 4, -4 ) a= -a3 
y| << endl; if( b < @) 
} |- b = -b; 
S 15 // now since they're both +ve, 
// we just have to compare equality of 
return a == b; 


20> char pgetGrade( int grade ) 


if( grade >= 80 ) 
return “A'; 





-= $ 


Here, we have three ples in this Visual C+ project: 


J- æ Header Files 
h] prototypes.h 
L Resource Files 


a “ay Source Files 
oo» &Ì funes.cpp 
&Ì main.cpp 





prototypes.h contains 


|| Make sure these prototypes are 

|| only included in compilation ONCE 
#pragma once 

extern int superglobal; // 
// function prototypes 


extern: variable "prototype" 


bool isPositive( double value ); 
bool absEqual( int a, int b ); 
char getGrade( int grade }; 


Theprototypes.h þle contains function prototypes. We will explain what the 
extern keyword does in afew paragraphs. 


oe 
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funcs.cpp contains 


#include "prototypes. h" // every file that uses isPositive, 
|| absEqual or getGrade must #include "prototypes. h" 

int superglobal; // variable "implementation" 

|| The actual function definitions are here, in the .cpp file 
bool isPositive( double value ) 


{ 
return value > 0; 
} 
bool absEqual( int a, int b ) 
{ 
|| Make a and b positive 
if( a <0) 
a = -a! 
if( by < 0: 3 
b = -b; 
|| now since they're both +ve, 
// we just have to compare equality of a and b together 
return a == b; 
} 


char getGrade( int grade ) 


if( grade >= 80 ) 


return ‘A’; 

else if( grade >= 70 ) 
return 'B'; 

else if( grade >= 60 ) 
recur “C4 

else if( grade >= 50 ) 
return 'D'; 

else 
return 'F'; 


main.cpp contains 


#include <iostream> 
using namespace std; 
#include "prototypes. h" // for use of isPositive, absEqual 
i Tuüunctrons 
int main() 
{ 
cout << boolalpha << isPositive( 4 ) << endl; 
cout << absEqual( 4, -4 ) << endl; 
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When you split up the codeinto. h and. cpp ples, the. h ble (the header ple) is 
called the interface and the. cpp ple (the one with the actual functions in it) is called 
the implementation. 


The puzzling part at prst for some programmers is how does C++ know where the 
isPositive andget Grade function bodies are, if weonly #i ncl ude the prototypes? 
Shouldn't we#i ncl ude thef uncs. cpp þleinto mai n. cpp too? 


The answer is magic. You only need to #i ncl ude theprototypes. h header þlein 
both main. cpp andf uncs. cpp. As long as both. cpp ples areincluded in your C+ 
Integrated D evelopment Environment (ID E) project (that is, they appear in the 
Solution Explorer tree view at the left-hand side), the linkup of the prototypes 

to the function bodies is done automatically by the compiler. 


Extern variables 


Anextern declaration is similar to a function prototype, only itis used on a variable. 
You can putanextern global variable declaration in an. h ple, and includethis. h 
blein a whole bunch of other þles. This way, you can have a single global variable 
that gets shared across multiple source bles, without getting the multiply depned 
symbols found linker error. You'd put the actual variable declaration ina. cpp 

ble so that the variable only gets declared once. Thereis anextern variablein the 
prototypes. h Plein the previous example. 


Macros 


C++ macros are from a class of C++ commands called preprocessor directives. 
A preprocessor directive is executed before compilation takes place. 


Macros start with #def i ne. For example, say we have the following macro: 


#define PI 3.14159 


At the lowest level, macros are simply copy and paste operations that occur just 
before compile time. In the preceding macro statement, the3. 14159 literal will be 
copied and pasted everywhere the symbol P| occurs in the program. 


Take an example of the following code: 


#include <iostream> 
using namespace std; 
#define Pl 3.14159 
int main() 


{ 
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double r = 4: 
cout << "Circumference is " << 2*Pl*r << endl: 


} 


What the C+ preprocessor will do is prst go through the code and look for any 
usage of the P| symbol. It will pnd one such usage on this line: 


cout << "Circumference is " << 2*Pl*r << endl; 
The preceding line will convert to the following just before compilation: 


cout << "Circumference is " << 2*%3,14159*r << endl: 


So, all that happens with a#def i ne statement is that all the occurrences of the 
symbol used (example, P| ) are replaced by the literal number 3. 14159 even before 
compilation occurs. The point of using macros in this way is to avoid hardcoding 
numbers into the code. Symbols are typically easier to read than big, long numbers. 


Advice — try to use const variables where 
possible 


You can use macros to deþne constant variables. You can also useconst variable 
expressions instead. So, say we have the following line of code: 


#define Pl 3.14159 
We will be encouraged to use the following Instead: 
const double PI = 3.14159: 


Using aconst variable will be encouraged because it stores your value inside an 
actual variable. The variable is typed, and typed data is a good thing. 


Macros with arguments 


We can also write macros that accept arguments. H ere's an example of a macro with 
an argument: 


#define println(X) cout << X << endl; 


What this macro will do is every timeprintln( "Some value") tsencountered in 
the code, the code on theright-hand side (cout << "Some value" << end! ) will be 
copied and pasted on the console. Notice how the argument between the brackets is 
copied in the place of X. Say we had the following line of code: 


printing. “hello: there ] 
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This will be replaced by the following statement: 


cout << "Hello there" << endl: 


Macros with arguments are exactly like very short functions. M acros cannot contain 
any newline characters in them. 


Advice — use inline functions instead of 
macros with arguments 


You have to know about how macros with arguments work because you will 
encounter them in C++ code a lot. Whenever possible, however, many C++ 
programmers prefer to use inline functions over macros with arguments. 


A normal function call execution involves aj ump instruction to the function and then 
the execution of the function. An inline function is one whose lines of code are copied 
to the point of the function call and no jump is issued. Using inline functions usually 
makes sense for very small, simple functions that don't havea lot of lines of code. For 
example, we might inline a simple function max that pnds the larger of two values: 


inline int max( int a, int b ) 
{ 

if( a> b ) return a: 

else return b; 


} 


Everywhere this max function is used, the code for the function body will be copied 
and pasted at the point of the function call. Not having toj ump to the function saves 
execution time, making inline functions effectively similar to macros. 


There is a catch to using inline functions. Inline functions must have their bodies 
completely contained in the. h header ple. This is so that the compiler can make 
optimizations and actually inline the function wherever it is used. Functions are 
made inline typically for soeed (since you don't have to jump to another body 

of the code to execute the function) but at the cost of code bloat. 


The following are the reasons why inline functions are preferred over macros: 


1. Macros are error prone: the argument to the macro is not typed. 
2. Macros have to be written in one line or you will see them using use escaped 


\ 

newline characters \ 
like this \ 

which is hard to read 
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3. Ifthe macro is not carefully written, it will result in difpcult-to-px compiler 
errors. For example, if you do not bracket your argument properly, your code 
will just be wrong. 


4. Large macros are hard to debug. 


It should be said that macros do allow you to perform some preprocessor compiler 
magic. UE4 makes a lot of use of macros with arguments, as you will see later. 


Summary 

Function calls allow you to reuse basic code. Code reuse is important for a number 
of reasons: mainly because programming is hard and duplicating effort should be 
avoided wherever possible. The efforts of the programmer that wrote thes qr t ( } 
function do not need to be repeated by other programmers who want to solve the 
same problem. 
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and Inheritance 


In the previous chapter, we discussed functions as a way to bundle up a 

bunch of lines of related code. We talked about how functions abstracted away 
implementation details and how thes qr t () function does not require you to 
understand how it works internally to use it to pnd roots. This was a good thing, 
primarily because it saved the programmer time and effort, while making the actual 
work of þnding square roots easier. This principle of abstraction will come up again 
here when we discuss objects. 


In anutshell, objects tie together methods and their related data into a single 
structure. This structure is called a class. The main idea of using objects is to create 
a code representation for every thing inside your game. Every object represented in 
the code will have data and associated functions that operate on that data. So you'd 
have an object to represent your player instance and related functions that make the 
playerj ump(),shoot(),andpickupltem() functions. You'd also have an object to 
represent every monster instance and related functions such asgr owl (),attack(), 
and possibly f ol | ow(). 


Objects are types of variables, though, and objects will stay in memory as long as you 
keep them there. You create an object instance once when the thing in your game 

it reoresents is created, and you destroy the object instance when the thing in your 
game it represents dies. 


Objects can be used to represent in-game things, but they can also be used to 
represent any other type of thing. For example, you can store an image as an object. 
The data belds will be the image's width of the image, its height, and the collection of 
pixels inside it. C+ strings are also objects. 
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This chapter contains a lot of keywords that might be difpcult to grasp 
at prst, includingvirtual andabstract. 
Don't let the more diffpcult sections of this chapter bog you down. | 
included descriptions of many advanced concepts for completeness. 
my However, bear in mind that you don't need to completely understand 

Q everything in this chapter to write working C+- code in UE4. It helps to 
understand it, but if something doesn't make sense, don't get stuck. Give 
ita read and then move on. Probably what will happen is you will not 
get it at prst, but remember a reference to the concept in question when 
you're coding. Then, when you open this book up again, "voil !" It will 
make sense. 


struct objects 


An object in C++ is basically any variable type that is made up of a conglomerate of 
simpler types. The most basic object in C++isstruct.Weusethestruct keyword 
to glue together a bunch of smaller variables into one big variable. If you recall, we 
did introducest ruct brieyy in Chapter 2, Variables and M emory. Let's revise that 
simple example: 


Struct Player 


{ 
string name: 
int hp; 

le 


This is the structure depnition for what makes aP! ayer object. The player has a 
string for hisname and an integer for hishp value. 


If you'll recall from Chapter 2, Variables and M emory, the way we make an instance 
of theP! ayer objectis like this: 


Player me; || create an instance of Player, called me 


From here, we can access the belds of the me object like so: 


me. name = "Tom"; 
me.hp = 100; 
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Member functions 


Now, here's the exciting part. We can attach member functions to thes t r uct 
depnition simply by writing these functions insidethestruct Player depnition. 


Struct Player 
{ 
string name: 
int hp; 
|| A member function that reduces player hp by some amount 
void damage( int amount ) 


{ 
hp -= amount; 
} 
void recover( int amount ) 
{ 
hp += amount; 
} 
ie 


A member function is just a C+ function that is declared insideastruct orcl ass 
depnition. Isn't that a great idea? 


There is a bit of a funny idea here, so I'll just come out and say it. The variables of 
struct Player areaccessibleto all thefunctionsinsidestruct Player. Insideeach 
of the member functions of struct Pl ayer ,wecan actually access thename and hp 
variables as if they were local to the function. In other words, thename andhp variables 
ofstruct Player areshared between all the member functions ofstruct Player. 


The this keyword 

In some C++ code (in later chapters), you will see more references to thet hi s 
keyword. Thet hi s keyword is a pointer that refers to the current object. Inside 
thePl ayer: :damage() function, for example, we can write our reference to 
this explicitly: 


void damage( int amount ) 


{ 
this->hp -= amount; 


} 


Thethi s keyword only makes sense inside a member function. We could explicitly 
include use of keyword t hi s inside member functions, but without writingt his, 
itis implied that we are talking about thehp of the current object. 
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Strings are objects? 


Yes! Every time you've used a string variable in the past, you were using an object. 
Let's try out some of the member functions of thes tring class. 


#include <iostream> 
#include <string> 
using namespace std; 


int main() 

{ 
string s = "strings are objects"; 
s.append( "!!" ); // add on "!!" to end of the string! 
cout << s << endl: 

} 


What we've done here is use theappend() member function to add on two extra 


characters to the end of the string (! ! ). Member functions always apply to the object 
that calls the member function (the object to the left of the dot). 


RS. To seethe listing of members and member functions available on an 
Q object, type the object's variable name in Visual Studio, then a dot (. ), 
then press Ctrl and spacebar. A member listing will pop up. 


4 
5i int main() 


|4 


string s = “strings are objects"; 
S. 


Y assign 
Yat 

Y begin 
®cstr 

Y capacity 
Y clear 

Y compare 
” copy 

Y data 





Pressing Ctrl and spacebar will make the member listing appear 
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Invoking a member function 


Member functions can be invoked with the following syntax: 
obj ectName. memberFuncti on(); 


The object invoking the member function is on the left of the dot. The member 
function to call is on the right of the dot. A member function invocation is always 
followed by round brackets ( ) , even when no arguments are passed to the brackets. 


So, in the part of the program where the monster attacks, we can reduce the player's 
hp value like so: 


player.damage( 15 ); // player takes 15 damage 


Which isn't that more readable than the following: 


player. hp -= 15: || player takes 15 damage 


A When member functions and objects are used effectively, your code 
Q will read more like prose or poetry than a bunch of operator symbols 
slammed together. 


Besides beauty and readability, what is the point of writing member functions? 
OutsidetheP| ayer object, we can now do more with a single line of code than just 
reducethehp member by 15. We can also do other things as we're reducing the 
player's hp, such as take into account the player's armor, check whether the player is 
invulnerable, or have other effects occur when the player is damaged. What happens 
when the player is damaged should be abstracted away by thedamage() function. 


Now think if the player had an armor class. Let's add abeldtostruct Player for 
armor class: 


Struct Player 


{ 
string name: 
int hp; 
int armorCl ass; 


ie 


We'd need to reduce the damage received by the player by the armor class of the 
player. So we'd type a formula now to reducehp. We can do it the non-object- 
oriented way by accessing the data belds of thep! ayer object directly: 


player. hp -= 15 - player.armorClass; // non OOP 
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Otherwise, we can do it the object-oriented way by writing a member function that 
changes the data members of thep! ayer object as needed. InsidetheP! ayer object, 
we can write a member function damage() : 


Struct Player 
{ 
string name: 
int hp; 
int armorCl ass; 
void damage( int dmgAmount ) 


{ 
hp -= dmgAmount - armorClass; 
} 
j 
Exercises 


1. Thereis a subtle bug in the player's da mage function in the preceding code. 
Can you þnd and px it? Hint: What happens if the damage dealt is less than 
armor Class ofthe player? 


2. Having only anumber for armor class doesn't give enough information 
about the armor! What is the armor's name? What does it look like? Devisea 
struct function for the Player's armor with belds for name, armor class, and 
durability rating. 


Solutions 


The solution isin thestruct player code listed in the next section, Privates 
and encapsulation. 


How about using the following code: 


Struct Armor 


{ 
string name: 
int armorClass: 
double durability; 
ie 


An instance of Ar mor will then be placed insidestruct Player: 


Struct Player 


{ 
string name: 
int hp; 
Armor armor; // Player has-an Armor 


}; 
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This means the player has an armor. Keep this in mind—welll explorehas- a versus 
i s-a relationships later. 


Privates and encapsulation 


So now we've debned a couple of member functions, whose purpose it is to modify 
and maintain the data members of our P| ayer object, but some people have come up 
with an argument. 


The argument is as follows: 


e An object's data members should only ever be accessed only through its 
member functions, never directly. 


This means that you should never access an object's data members from outside the 
object directly, in other words, modify the player'shp directly: 


player. hp -= 15 - player.armorClass; // bad: direct member access 


This should be forbidden, and users of the class should be forced to use the proper 
member functions instead to change the values of data members: 


player. damage( 15 ); || right: access thru member function 


This principle is called encapsulation. Encapsulation is the concept that every object 
should be interacted via its member functions only. Encapsulation says that raw data 
members should never be accessed directly. 


The reasons behind encapsulation are: 


e To make the class self contained: The primary idea behind encapsulation is 
that objects work best when they are programmed such that they manage and 
maintain their own internal state variables without a need for code outside the 
class to examine that class’ private data. When objects are coded this way, it 
makes the object much easier to work with, that is, easier to read and maintain. 
To make the player object jump, you should just haveto call p! ayer. j ump() ; 
let the player object manage state changes to itsy- hei ght position (making the 
player jump!). When an object's internal members are not exposed, interacting 
with that object is much easier and more effcient. Interact only with an object's 
public member functions; let the object manage its internal state (we will 
explain the keywordspri vate and publ i c in a moment). 
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e Toavoid breaking code: When code outside of a class interacts with that 
class' public member functions only (the class' public interface), then an 
object's internal state management is free to change, without breaking any 
of the calling code. This way, if an object's internal data members change for 
any reason, all code using the object still remains valid as long as the member 
functions remain the same. 


So how can we prevent the programmer from doing the wrong thing and accessing 
data members directly? C++ introduces the concept of access modibers to prevent 
access of an object's internal data. 


Hereis how wed use access modibers to forbid access to certain sections of st ruct 
Pl ayer from outsideofstruct Player. 


The prst thing you'd do is decide which sections of thes t r uct depnition you want 
to be accessible outside of the class. These section will belabelled pub! i c. All other 
regions that will not be accessible outside of struct will belabelled private, 

as follows: 


Struct Player 


{ 
private: || begins private section.. cannot be accessed 
// outside the class until 
string name: 
int hp; 
int armorCl ass; 
public: // until HERE. This begins the public section 
|| This member function is accessible outside the struct 
|| because it is in the section marked public: 
void damage( int amount ) 
{ 
int reduction = amount - armorClass; 
if( reduction < 0 ) // make sure non-negative! 
reduction = 0; 
hp -= reduction; 
} 
j 


Some people like it public 
Some people do unabashedly usepub! i c data members and do not encapsulate 


their objects. This is a matter of preference, though considered as bad object-oriented 
programming practice. 
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However, classes in UE4 do usepub! i c members sometimes. It's a judgment 
call; whether a data member should bepublic orprivate isreally up to 
the programmer. 


With experience, you will pnd that sometimes you get into a situation that requires 
quite a bit of refactoring when you make a data member pub! i c that should have 
been private. 


class versus struct 


You might have seen a different way of declaring an object, using thec | ass 
keyword, instead of st r uct , as shown in the following code: 


class Player // we used class here instead of struct! 


{ 


string name: 
| | 
}; 


Thecl ass andstruct keywords in C+ are almost identical. There is only one 
difference between class andstruct,and itis that the data members inside a 
struct keyword will be declared publ i c by default, whilein ac! ass keyword 
the data members inside the class will be declared pr i vat e by default. (This is why 
| introduced objects usingstr uct ; | didn't want to putpubl i c inexplicably as the 
brst lineofclass.) 


In general,struct is preferred for simple types that don't use encapsulation, don't 
have many member functions, and must be backward compatible with C. Classes are 
used almost everywhere else. 


From now on, let's usethec| ass keyword instead ofstruct. 


Getters and setters 


You might have noticed that once we slap pri vate ontotheP! ayer class depnition, 
we can no longer read or write the name of the player from outsidetheP! ayer class. 


If wetry and read the name with the following code: 


Player me; 
cout << me. name << endl: 


Or write to the name, as follows: 


me. name = "Wiliam": 
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Usingthestruct Pl ayer depnition with private members, we will get the 
following error: 


main.cpp(24) : error C2248: ‘Player::name' : cannot access private 
member declared in class ‘Player’ 


This is just what we asked for when we labeled thename beld pri vate. We madeit 
completely inaccessible outside the P| ayer class. 


Getters 


A getter (also Known as an accessor function) is used to pass back copies of internal 
data members to the caller. To read the player's name, we'd deck out theP! ayer class 
with a member function specipcally to retrieve a copy of that pri vat e data member: 


class Player 
{ 
private: 
string name; // inaccessible outside this class! 
// rest of class as before 
public: 
// A getter function retrieves a copy of a variable for you 
string getName( ) 
{ 
return name; 
} 
K 


So now it is possible to read the player's name information. We can do this by using 
the following code statement: 


cout << player.getName() << endl: 


Getters are used to retrievepr i vate members that would otherwise be inaccessible 
to you from outside the class. 
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Real world tip-K eyword const 


Inside a class, you can add thec onst keyword to a member function 
declaration. What thec onst keyword does is promises to the 
compiler that the internal state of the object will not change as a result 
of running this function. Attaching theconst keyword will look 
something like this: 


my string getName() const 
Q l 
return name; 
} 


No assignments to data members can happen inside a member 
function that is marked const . As the internal state of the object is 
guaranteed not to change as a result of runningaconst function, 
the compiler can make some optimizations around function calls to 
const member functions. 


Setters 


A setter (also known as a modiper function or mutator function) is a member 
function whose sole purpose is to change the value of an internal variable inside 
the class, as shown in the following code: 


class Player 


{ 
private: 
string name; // inaccessible outside this class! 
// rest of class as before 
public: 
// A getter function retrieves a copy of a variable for you 
string get Name{ } 
{ 
return name; 
} 
void setName( string newName ) 
{ 
name = newName: 
} 


j 
So we can still change the pri vate function of ac! ass from outsidethec| ass 
function, but only if wedo so through a setter function. 
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Dwy j cvu'\i g't qlovaghi gvugvVar gtcvqpuA 


So the prst question that crosses a newbie programmer's mind when he prst 
encounters get/ set operations on pri vat e members is, isn't get/ set self-defeating? 
| mean, what's the point in hiding access to data members when we're just going to 
expose that same data again in another way? It's like saying, "You can't have any 
chocolates because they are private, unless you say pleaseget MeTheChocol ate(). 
Then, you can have the chocolates." 


Some expert programmers even shorten the get/ set functions to one liners, like this: 


string getName(){ return name; } 
void setName( string newName ){ name = newName; } 


Let's answer the question. Doesn't a get/ set pair break encapsulation by exposing the 
data completely? 


The answer is twofold. First, get member functions typically only return a copy of 
the data member being accessed. This means that the original data member's value 
remains protected and is not modipable through aget () operation. 


Set() (mutator method) operations are a little bit counterintuitive though. If 

the setter isapassthru operation, such asvoid setName( string newName ) 

{ name=newName; }, then having the setter might seem pointless. What is the 
advantage of using a mutator method instead of overwriting the variable directly? 


The argument for using mutator methods is to write additional code before the 
assignment of a variable to guard the variable from taking on incorrect values. 
Say, for example, we havea setter for theh p data member, which will look like this: 


void setHp( int newHp ) 
{ 


|| guard the hp variable from taking on negative values 
if( newHp < 0 ) 
{ 


cout << "Error, player hp cannot be less than 0" << endl; 
newHp = 0; 
} 
h 
} 


The mutator method is supposed to prevent the internal hp data member from taking 
on negative values. You might consider mutator methods a bit retroactive. Should 
the responsibility lie with the calling code to check the value it is setting before calling 
setHp( -2 ),andnotlet that only get caught in the mutator method? Can't you use 
apub! ic member variable and put the responsibility for making sure the variable 
doesn't take on invalid values in the calling code, instead of in the setter? You can. 


p = newHp; 
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However, this is the core of the reason behind using mutator methods. The idea 
behind mutator methods is so that the calling code can pass any value it wants to the 
set Hp function (for example,setHp( -2 ) ), without having to worry whether the 
value it IS passing to the function is valid or not. Thes et Hp function then takes the 
responsibility of ensuring that the value Is valid for thehp variable. 


Some programmers consider direct mutator functions such asget Hp()/setHp() a 
code smell. A code smell is in general a bad programming practice that people don't 
overtly take notice of, except for a niggling feeling that something is being done 
suboptimally. They argue that higher-level member functions can be written instead 
of mutators. For example, instead of as et Hp( ) member function, we should have 
publ ic member functions such aSheal () anddamage() instead. An article on this 
topicisavailableathttp://c2.com/cgi/wiki?AccessorsAreEvil. 


Constructors and destructors 


The constructor in your C++ code is a simple little function that runs once when 
the C++ object is prst created. The destructor runs once when the C++ object is 
destroyed. Say we have the following program: 


#include <iostream> 
#include <string> 
using namespace std; 
class Player 
{ 
private: 

string name; // 
public: 

string getName(){ return name; } 
|| The constructor! 

Player() 

{ 


naccessible outside this class! 


cout << "Player object constructed" << endl: 
name = "Diplo"; 

} 

|| ~Destructor (~ is not a typo!) 

~Pl ayer() 

{ 


cout << "Player object destroyed" << endl; 
} 
K 


int main() 


{ 
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Player player; 
cout << "Player named '" << player.getName() << "'" << endl; 


} 
// player object destroyed here 


So here we have created aP | ayer object. The output of this code will be as follows: 


Player object constructed 
Player named ‘Diplo’ 
Player object destroyed 


The prst thing that happens during object construction is that the constructor 
actually runs. This prints thelineP| ayer object constructed. Following this, 
the line with the player's name gets printed: P! ayer named 'Diplo'.Whyisthe 
player named D iplo? Because that is the name assigned in the P! ayer () constructor. 


Finally, at the end of the program, the player destructor gets called, and we see 
Player object destroyed. The player object gets destroyed when it goes out of 
scope at the end of mai n() (at} of mai n). 


So what are constructors and destructors good for? Exactly what they appear to 
be for: setting up and tearing down of an object. The constructor can be used for 
initialization of data belds and the destructor to call delete on any dynamically 
allocated resources (we haven't covered dynamically allocated resources yet, 

so don't worry about this last point yet). 


Class inheritance 


You use inheritance when you want to create a new, more functional class of code, 
based on some existing class of code. Inheritance Is a tricky topic to cover. Let's start 
with the concept of a derived class (or subclass). 


Derived classes 


The most natural way to consider inheritance is by analogy with the animal 
kingdom. The classifpcation of living things is shown in the following screenshot: 


Mammal 


['33:'] 


www.it-ebooks.info 


Chapter 6 


What this diagram means is that D og, Cat, Horse, and Human are all Mammals. What 
that means is that dog, cat, horse, and human all share some common characteristics, 
such as having common organs (brain with neocortex, lungs, liver, and uterus 

in females), while being completely different in other regard. How each walksis 
different. How each talks is also different. 


What does that mean if you were coding creatures? You would only have to program 
the common functionality once. Then, you would implement the code for the 
different parts specipcally for each of the dog, cat, horse and human classes. 


A concrete example of the preceding bgure is as follows: 


#include <iostream> 
using namespace std: 
class Mammal 
{ 
protected: 
|| protected variables are like privates: they are 
|| accessible in this class but not outside the class. 
|| the difference between protected and private is 
|| protected means accessible in derived subclasses also 
int hp; 
double speed; 


public: 
// Mammal constructor - runs FIRST before derived class ctors! 
Mammal ( ) 
{ 
hp = 100; 
Speed = 1.0; 
cout << "A mammal is created!" << endl: 
} 
~Ma mmal ( ) 
{ 
cout << "A mammal has fallen!" << endl: 
} 
// Common function to all Mammals and derivatives 
void breat he() 
{ 


cout << "Breathe in.. breathe out" << endl: 


} 
virtual void tal k() 
{ 
cout << "Mammal talk.. override this function!" << endl: 
} 
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|| pure virtual function, (explained bel ow) 
virtual void walk() = 0; 


i 
|| This next line says "class Dog inherits from class Mammal " 
class Dog : public Mammal // : is used for inheritance 
{ 
public: 
Dog() 
{ 
cout << "A dog is born!" << endl: 
} 
~Dog() 
{ 
cout << "The dog died" << endl; 
} 
virtual void talk() override 
{ 
cout << "Woof!" << endl; // dogs only say woof! 
} 
// implements walking for a dog 
virtual void walk() override 
{ 
cout << "Left front paw & back right paw, right front paw & 
back left paw.. at the speed of " << speed << endl; 
} 
$ 
class Cat : public Mammal 
{ 
public: 
Cat () 
{ 
cout << "A cat is born" << endl: 
} 
~Cat() 
{ 
cout << "The cat has died" << endl: 
} 
virtual void talk() override 
{ 
cout << "Meow!" << endl; 
} 


|| implements walking for a cat.. same as dog! 
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virtual void walk() override 


{ 
cout << "Left front paw & back right paw, right front paw & 
back left paw.. at the speed of " << speed << endl; 


} 
}; 


class Human : public Mammal 


{ 


|| Data member unique to Human (not found in other Mammals) 
bool civilized: 


public: 
Human( ) 
{ 


cout << "A new human is born" << endl; 

Speed = 2.0; // change speed. Since derived class ctor 
// (ctor is short for constructor!) runs after base 

// class ctor, initialization sticks initialize member 
// variables specific to this class 

civilized = true; 


} 
~Human( } 
{ 
cout << "The human has died" << endl: 
} 
virtual void talk() override 
{ 
cout << "I'm good looking for a .. human" << endl: 
} 


|| implements walking for a human. 
virtual void walk() override 
{ 
cout << "Left, right, left, right at the speed of " << speed 
<< endl; 
} 
|| member function unique to human derivative 
void attack( Human & other ) 
{ 
|| Human refuses to attack if civilized 
if( civilized ) 
cout << "Why would a human attack another? Je refuse" << 
endl ; 
else 
cout << "A human attacks another!" << endl: 
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}; 


int 


{ 


} 


} 


mai n( ) 


Human human: 


human. breathe(); // breathe using Mammal base class 
functionality 


human. tal k(); 
human. wal k(): 


Cat 

cat. 
cat. 
cat. 


Dog 

dog. 
dog. 
dog. 


cat; 

breathe(); // breathe using Mammal base class functionality 
tal k(); 

wal k(); 


dog; 
breathe(); 
tal k(); 
wal k(); 


All of Dog, Cat , and Human inherit fromclass Mammal . This means that dog, cat, and 
human are mammals, and many more. 


Syntax of inheritance 


The syntax of inheritance is quite simple. Let's take the Human class depnition as an 
example. The following screenshot is a typical inheritance statement: 


new, inheriting The colon means The class to 
class - derived “inherits from", inherit from - 
class or, "is-a" base class 





The class on the left of the colon (:) is the new, derived class, and the class on the 
right of the colon is the base class. 
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What does inheritance do? 


The point of inheritance is for the derived class to take on all the characteristics (data 
members, member functions) of the base class, and then to extend it with even more 
functionality. For instance, all mammals have abr eat he() function. By inheriting 
from theMa mmal class, theDog,Cat , and Human classes all automatically gain the 
ability tobreathe(). 


Inheritance reduces replication of code since we don't have to re-implement common 
functionalities (such as. breat he() )forDog,Cat , and Human. Instead, each of these 
derived classes enjoys the reuse of thebr eat he() function depned inc! ass Mammal. 


However, only theHuman class has theat t ack( ) member function. This would mean 
that, in our code, only theHu man class attacks. Thecat. att ack() function will 
introduce a compiler error, unless you write a member function at tack() inside 
class Cat (orinclass Mammal ). 


is-a relationship 


Inheritance is often said to be ani s-a relationship. When a Human class inherits from 
Mammal class, then we say that human is-a mammal. 


Mamma 
has: Heart 
Blood 
Lungs 





The Human inherits all the traits a Mammal has 


For example, aHuman object contains a Mamma! function inside it, as follows: 


class Human 


{ 


Mammal mammal : 


iz 
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In this example, we would say the human has-a Mamma! on it Somewhere (which 
would make sense if the human were pregnant, or somehow carrying a mammal). 


Human 


Has: | Mammal 


This Human class instance has some kind of mammal attached in it 





Remember that we previously gaveP!| ayer anAr mor object inside it. It wouldn't 
make sense for theP | ayer object to inherit from theAr mor class, because it wouldn't 
make sense to say the Player is-an Armor. When deciding whether one class inherits 
from another or not in code design (for example, the Human class inherits from 

the Mammal class), you must always be able to comfortably say something like the 
Human class is-a Mammal. If the is-a statement sounds wrong, then it is likely that 
inheritance is the wrong relationship for that pair of objects. 


In the preceding example, were introducing afew new C++keywords here. The prst 
ISprotected. 


protected variables 


A protected member variable is different from apublic orprivate variable All 
three classes of variables are accessible inside the class in which they are debned. 
The difference between them is in regard to accessibility outside the class. A publ ic 
variable is accessible anywhere inside the class and outside the class. A private 
variable is accessible inside the class but not outside the class. A protected variable 
is accessible inside the class, and inside of derived subclasses, but is not accessible 
outside the class. So, thehp ands peed members of cl ass Mammal will be accessible 
in the derived classes Dog, Cat, Horse, and Human, but not outside of these classes 
(in mai n() for instance). 


Virtual functions 


A virtual function is a member function whose implementation can be overridden 
in a derived class. In this example, thet al k() member function (depned inc! ass 
Mammal ) is marked virtual . This means that the derived classes might or might not 
choose to implement their own version of what thet a! k() member function means. 
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Purely virtual functions (and abstract classes) 


A purely virtual function is one whose implementation you are required to override 
in the derived class. Thewal k() functionincl ass Mammal is purely virtual; it was 
declared like this: 


virtual void walk() = 0; 


The= 0 part at the end of the preceding code is what makes the function purely 
virtual. 


Thewalk() functionincl ass Mammal ispurelyvirtual and this makes the 
Mammal class abstract. An abstract class in C++ is any class that has at least one 
purely virtual function. 


If a dass contains a purely virtual function and is abstract, then that class cannot be 
instantiated directly. That is, you cannot create a Mammal! object now, on account of 
the purely virtual function wal k() . If you tried to do the following code, you would 
get an error: 


int mali n() 


{ 


Mammal mammal : 


} 
If you try to createa Mamma! object, you will get the following error: 
error C2259: 'Mammal' : cannot instantiate abstract class 


You can, however, create instances of derivatives of cl ass Mammal , as long as the 
derived classes have all of the purely virtual member functions implemented. 


Multiple inheritance 


Not everything multiple is as good as it sounds. Multiple inheritance is when a 
derived class inherits from more than one base class. Usually, this works without a 
hitch if the multiple base classes we are inheriting from are completely unrelated. 
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For example, we can havea class Wi ndow that inherits from theS oundManager 

and GraphicsManager base classes. IfSoundManager provides a member function 

pl aySound() andGraphicsManager provides a member function drawSprite(), 
then the Wi ndow class will be able to use those additional capabilities without a hitch. 


Game Window inheriting from Sound Man and Graphics Man means Game Window will have both sets 
of capabilities 





However, multiple inheritance can have negative consequences. Say we want 

to create a class Mul e that derives from both theDonkey and Horse classes. The 
Donkey and Horse classes, however, both inherit from the base class Mamma! . We 
instantly have an issue! If we were to call mul e. tal k() , but mul e does not override 
thet al k() function, which member function should be invoked, that of Horse or 
Donkey? It's ambiguous. 


private inheritance 


A less talked about feature of C++ispri vate inheritance. Whenever a class inherits 
from another class publicly, it is Known to all code whose parent class it belongs to. 
For example: 


class Cat : public Mammal 


This means that all code will know that Cat isan object of Mamma! , and it will be 
possible to point to aCat * instance using a base class Mamma! * pointer. For example, 
the following code will be valid: 


Cat cat: 
Mammal * mammal Ptr = &cat; // Point to the Cat as if it were a 
|| Mammal 


The preceding codeis pneif Cat inherits from Mammal publicly. Private inheritance Is 
where code outside theCat class is not allowed to know the parent class: 


class Cat : private Mammal 
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Here, externally calling code will not "know" that the Cat class derives from the 
Mammal class. Casting aCat instance to theMamma! base class is not allowed by the 
compiler when inheritance isprivate.Useprivate inheritance when you need to 
hide the fact that a certain class derives from a certain parent class. 


However, private inheritance is rarely used in practice. Most classes just usepub! ic 
Inheritance. If you want to Know more about private inheritance, seeht tp: / / 
Stackoverflow.com/questions/406081/ why-should-i-avoid-multiple- 


inheritance-In-c. 


Putting your classes into headers 


So far, our classes have just been pasted before mai n() . If you continue to program 
that way, your code will all bein one ble and appear as one big disorganized mess. 


Therefore, it is a good programming practice to organize your classes into separate 
bles. This makes editing each class's code individually much easier when there are 
multiple classes inside the project. 


Takec!ass Mamma! and its derived classes from earlier. We will properly organize 
that example into separate ples. Let's do it in steps: 


1. Createanew plein your C++ project called Mammal . h. Cut and paste the entire 
Mammal class into that ple. Notice that since the Mamma! class included the use 
of cout, wewritea#i nclude <iostream> statenent in that pleas well. 


2. Writea"#incl ude Mammal . h" statement at the top of your Source. cpp ple. 


An example of what this looks like is shown in the following screenshot: 


400 


nen! T Dt : = ibeh Pena © z Ei: Trig 
#include <iostream> t +| #include <iostream> 

1] using namespace std; z using namespace std; 
sc 


#include "“Mammal_h" ifi=class Mammal 
5 sii{ 


5f // Thais next line says "class Dog inhe 5| | protected: 
Tt-class Dog ; public Mammal // Mis used ri // protected variables are accessible 
z {l E // but not outside the class 
4] public: z int hp; 
Dogi ) A double speed; 


cout << "A dog 1s born!” <q 6 12] publie: 
// Mammal constructor = runs FIRST bef 


~Dogt } 14 Mammal ft} 
i { 


cout << "The dog died” << end 16 hp = 168; 
} i? speed = 1.8; 
virtual void talk() override 18| cout <¢ "A mammal is created!" << 
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What's happening here when the code is compiled is that the entireMammal class is 
copied and pasted (#include) into theSource. cpp ble, which contains the mai n( ) 
function, and the rest of the classes are derived from Mammal . Since #i ncl ude isa 
copy and paste function, the code will function exactly the same as it did before; the 
only difference is that it will be much better organized and easier to look at. Compile 
and run your code at this step to make sure it still works. 


Check that your code compiles and runs often, especially when 
refactoring. When you don't know the rules, you're bound to make a lot 
>< of mistakes. This is why you should do your refactoring only in small 
Q steps. Refactoring is the name for the activity we are doing now—we 
are reorganizing the source to make better sense to other readers of our 
codebase. Refactoring usually does not involve rewriting too much of it. 


The next thing you need to do is isolate the Dog, Cat, and H uman classes into 
their own bles. To do so, createtheDog. h, Cat. h, and Human. h ples and add them 
to your project. 


Let's start with the Dog class, as shown in the following screenshot: 


] =) peat a - fiotel Hipi - - L a Giai Hops . 
i] #include <iostream> 1 #include <iostream> ij #include <iostream> 
2] using namespace std: 7 2 using namespace std; Š 2] using namespace std: 


#inglude -Mammal . h" 4 #include “Mammal.” Lieclass- Mammal 
Se #include "Dog. h" 


| 5 J7 This mext line says A] protected: 
MWeclass Cat : public Mammal 7 etlass Dog : public Mamm ; // protected variab 
a} { A 4 E // but not outside 
aj public: 3 ‘public: 5 int hp; 

Catt) ig Dogi) Lé double speed; 


féout << "A cat is born 12 fout <4 "A dog 124 public: 
} 13 } 13 /? Mammal constructd 
Cati ) id ~Dogt ) i4 Mammal (} 
15 { 


{ 





If you use exactly this setup and try to compile and run your project, you will see the 
'Mammal' : 'dass' type redepnition error, as shown in the following screenshot: 


Error List 


T = Queers 


Description 
E1 error C2011: "Mammal" : "class" type redefinition 





What this error means is that Ma mma | . h has been included twice in your project, 
onceinSource. cpp and then again in Dog. h. This means effectively two versions 
of the Mammal class got added to the compiling code, and C++ is unsure which 
version to use. 


['34:"] 


www.it-ebooks.info 


Chapter 6 


There are a few ways to bx this issue, but the easiest (and the one that Unreal Engine 
uses) isthe #pragma once macro, as shown in the following screenshot: 


E 
ry 
= 
or 
= 
fa 
a 
= 
a 
Ee 
Er 
H 
ii 
i 
o 
Ti 
th 
af j 


H eepo 


#include tiostream> 
using namespace std; 
#include <iostream> 
using namespace std; 


Ro) ae 


#include <iostream> 
a#include "Mammal .h" using namespace std: 


#include "Dog.h" 


mao & W 


#include “Mammal.h" class Mammal 
2class Cat : public Mammal 
{ 
public: 

Cat{) 


// This next line says protected: 
class Dog : public Mamm // protected variab 
{ 1 /f but not outside 
public: i int hp; 

Dog()} 12 double speed; 

{ 13 


Wow qin B w 


1 
2 
3 
4 
5 
6 
? 
8 
g 
a 
1 


cout << "A cat is born' 





We mw om a 


1 
1 
1 
1 


HHHH 


W Pl 


Wewrite#pragma once atthe top of each header ble. This way, the second time 

Ma mmal . h is included, the compiler doesn't copy and paste its contents again, since it 
already has been included before, and its content is actually already in the compiling 
group of bles. 


Do the same thing for Cat. h and Human. h, theni nci ude them both into your 
Source. cpp ble where your mai n() function resides. 


č 
E 


#includè <iostream> T | #include ¿if 
using namespace std: 2] using names, 
#include tig s 

using nmamesp 4] #include “F 


#pragma onct 1| #pragma ong 


#include af 3] #include < 

=#include "Mammal, Rh" using names 1] using named 
finclude "Dog. h” 

#include "Cat. h" 

#include "Human. h" 


#include "P bjiclass Mamma 
7i i 

// This nex | protected: 

élass Dag : z] i pre 


class Cat : 
{ 
public: 
Cat() 
{ 


CQ 


#include “Ma 


elass Human 
int maint) 


Dit Ww fF ei We 


// Data memb 
Human human; bool gi 
human. breathel }; 12] public: 


{ 18 | if But 
public: 11) int hp 
È double 


Bg Oo ow om i em ow 
i i 
Bw oo e o A e a i bèii 


ï jä 





ha bi Œ W 0 ad i 


ee 
Pd 


Diagram with all classes included 


Now that we've included all classes into your project, the code should compile 
and run. 


.h and .cpp 


The next level of organization is to leave the class declarations in the header ples (. h) 
and put the actual function implementation bodies inside some new . cpp ples. Also, 
leave existing members insidethec! ass Mamma! declaration. 
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For each class, perform the following operations: 


1. Delete all function bodies (code between { and } ) and replace them with just 
a semicolon. For theMamma! class, this would look as follows: 


|| Mammal. h 
#pragma once 
class Mammal 
{ 
protected: 
int hp; 
double speed; 


public: 
Ma mmal () ; 
~Ma mmal () ; 
void breathe(); 
virtual void talk(); 
// pure virtual function, 
virtual void walk() = 0; 


F 
2. Createa new. cpp þle called Mamma! . cpp. Then simply put the member 
function bodies inside this ple: 


|| Mammal.cpp 
#include <iostream> 
using namespace std: 


#include "Mammal. h" 


Mammal::Mammal() // Notice use of :: (scope resolution operator) 
{ 
hp = 100; 
Speed = 1.0; 
cout << "A mammal is created!" << endl: 
} 
Mammal: : ~Ma mmal ( ) 
{ 
cout << "A mammal has fallen!" << endl: 
} 
void Mammal:: breathe( ) 
{ 
cout << "Breathe in.. breathe out" << endl: 
} 
void Mammal::talk() 
{ 
cout << "Mammal talk.. override this function!" << endl: 
} 
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It is important to note the use of the class name and scope resolution operator 
(double colon) when declaring the member function bodies. We prepx all member 
functions belonging to the Mamma! class with Mammal :: . 


N otice how the purely virtual function does not havea body; it's not supposed to! 
Purely virtual functions are simply declared (and initialized to 0) in the base class, 
but implemented later in derived classes. 


Exercise 


Complete the separation of the different creature classes above into class header (. h) 
and class depnition ples (. cpp) 


Summary 


You learned about objects in C+ they are pieces of code that tie data members 

and member functions together into a bundle of code called class orstruct. 
Object-oriented programming means that your code will be plled with things 
instead of justi nt ,float,andchar variables. You will havea variable that 
represents Barrel! , another variable that represents P| ayer , and so on, that is, a 
variable to represent every entity in your game. You will be able to reuse code by 
using inheritance; if you had to code implementations of Cat and Dog, you can code 
a common functionality in the base class Mamma! . We also discussed encapsulation 
and how it is easier and more efpcient to program objects such that they maintain 
their own internal state. 
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Dynamic Memory Allocation 


In the previous chapter, we talked about class depnitions and how to devise your 
own custom class. We discussed how by devising our own custom classes, we can 
construct variables that represented entities within your game or program. 


In this chapter, we will talk about dynamic memory allocations and how to create 
Space in memory for groups of objects. 


Assume that we havea simpliped version of cl ass PI ayer ,as before, with only a 
constructor and a destructor: 


class Player 
{ 
string name: 
int hp; 
public: 
Player(){ cout << "Player born" << endl; } 
~Player(){ cout << "Player died" << endl; } 


}; 
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We talked earlier about the scope of a variable in C+ to recap, the scope of a variable 
is the section of the program where that variable can be used. The scope of a variable is 
generally inside the block in which it was declared. A block is just any section of code 
contained between {and } Hereis a sample program that illustrates variable scope: 


int main() 


{ ne begin main() block 


int X; => x's scope is from here to the end of main{} 


if( some_condition ) 
{ ww begin if block 

int Y, y's scope is from here to the end of the if 
} — end if block [y destroyed] 


}______, end main{}) block, [x destroyed] 





In this sample program, the x variable has scope through all of main(). The y variable's scope is only inside the 
if block 


We mentioned previously that in general variables are destroyed when they go out 
of scope. Let's test this idea out with Instances of cl ass Player: 


int mai n() 


{ 
Player player; // "Player born" 
} // “Player died" - player object destroyed here 


The output of this program is as follows: 


Player born 
Player died 


The destructor for the player object is called at the end of the player object's scope. 
Since the scope of a variable is the block within which it is depned in the three lines 
of code, theP | ayer object would be destroyed immediately at the end of main(), 
when it goes out of scope. 
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Now, let's try allocating aP| ayer object dynamically. What does that mean? 


Weusethenew keyword to allocate it! 


int main() 

{ 
|| “dynamic allocation" - using keyword new! 
|| this style of allocation means that the player object wil 
// NOT be deleted automatically at the end of the block where 
|| it was declared! 

Player *player = new Player(); 

} // NO automatic deletion! 


The output of this program is as follows: 


Player born 


The player does not die! How do we kill the player? We must explicitly call del et e 
on thep! ayer pointer. 


The delete keyword 


Thedel ete operator invokes the destructor on the object being deleted, as shown in 
the following code: 


int mai n() 

{ 
|| “dynamic allocation" - using keyword new! 
Player *player = new Player(); 
delete player; // deletion invokes dtor 


} 
The output of the program is as follows: 


Player born 
Player died 


So, only "normal" (or "automatic" also called as non-pointer type) variable types 
get destroyed at the end of the block in which they were declared. Pointer types 
(variables declared with* and new) arenot automatically destroyed even when 

they go out of scope. 


What is the use of this? Dynamic allocations let you control when an object is created 
and destroyed. This will comein handy later. 
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Memory leaks 


So dynamically allocated objects created with new arenot automatically deleted, 
unless you explicitly call de! ete on them. Thereis a risk here! It is called a memory 
leak. Memory leaks happen when an object allocated with new is not ever deleted. 
What can happen is that if a lot of objects in your program are allocated with new and 
then you stop using them, your computer will run out of memory eventually due to 
memory leakage. 


Here is a ridiculous sample program to illustrate the problem: 


#include <iostream> 
#include <string> 
using namespace std: 
class Player 
{ 
string name: 
int hp; 
public: 
Player(){ cout << "Player born" << endl; } 
~Player(){ cout << "Player died" << endl; } 


is 
int mai n() 
{ 
while( true ) // keep going forever, 
{ 
[/ alloc.. 
Player *player = new Player(); 
// without delete == Memory Leak! 
} 
} 


This program, if left to run long enough, will eventually gobble the computer's 
memory, as shown in the following screenshot: 


Name Status CPU Memory 





E| dynmem.exe (32 bit) 26.3% 1,961.9 MB 


2 GB of RAM used for Player objects! 


Note that no one ever intends to write a program with this type of problem tn it! 
Memory leak problems happen accidentally. You must take care of your memory 
allocations and de! et e objects that are no longer in use. 
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Regular arrays 


An array in C++ can be declared as follows: 


#include <iostream> 
using namespace std; 


int main() 
{ 
int array[ 5 ]; // declare an "array" of 5 integers 
// fill slots 0-4 with values 

array[ 0 ] = 1; 

array[ 1 ] = 2; 

array[ 2 ] = 3; 

array[ 3 |] = 4; 


array[ 4 ] = 5; 
// print out the contents 
for( int index = 0; Index < 5; Index++ ) 
cout << array[ Index ] << endl; 


} 


The way this looks in memory is something like this: 


element 


index 





That is, insidethearray variable are pve slots or elements. Inside each of the slots is 
aregulari nt variable. 


The array syntax 


So, how do you access one of thei nt valuesin the array? To access the individual 
elements of an array, we use square brackets, as shown in the following line of code: 


array[ 0 ] = 10; 
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The preceding line of code would change the element at slot 0 of the array to a 10: 





array 


In general, to get to a particular slot of an array, you will write the following: 


array{ slotNumber ] = value to put into array; 


Keep in mind that array slots are always indexed starting from 0. To get into the 

brst slot of the array, usearray[ 0] . The second slot of the array isarray[1] (not 
array[2]). Thepnal slot of the array aboveisarray[4] (notarray[5]). The 
array[5] datatype ts out of bounds of the array! (There is no slot with index 5in the 
preceding diagram. The highest index Is 4.) 


Don't go out of bounds of the array! It might work some times, but other times your 
program will crash with amemory access violation (accessing memory that doesn't 
belong to your program). In general, accessing memory that does not belong to your 
program is going to cause your app to crash, and if it doesn't do so immediately, 
there will be a hidden bug in your program that only causes problems once ina 
while. You must always be careful when indexing an array. 


Arrays are built into C+, that is, you don't need to include anything special to have 
immediate use of arrays. You can have arrays of any type of data that you want, for 
example, arrays of i nt ,doubl e,string, and even your own custom object types 

(Pl ayer). 


Exercise 


1. Createan array of pve strings and put inside it some names (made up or 
random, it doesn't matter). 


2. Createan array of doubles called t emps with three elements and store the 
temperature for the last three days in it. 
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Solutions 
1. Thefollowing isasample program with an array of pve strings: 


#include <iostream> 
#include <string> 
using namespace std: 


int main() 
{ 
string array[ 5 ]; // declare an "array" of 5 strings 
// fill slots 0-4 with values 
array[ 0 |] = "Mariam McGonical": 
array[ 1 ] = "Wesley Snice'; 
array[ 2 ] = "Kate Winslett"; 
array[ 3 ] = "Erika Badu", 
array[ 4 ] = "Mohammad": 


// print out the contents 
for( int index = 0; Index < 5; Index++ ) 
cout << array[ index ] << endl; 


} 


2. Thefollowing is just the array: 


double temps[ 3 ]; 

// fill slots 0-2 with values 
temps 0 ] = 0; 

temps[ 1 ] = 4.5; 

temps 2 ] = 11; 


C++ style dynamic size arrays (new[] and 
delete[]) 


It probably occurred to you that we won't always know the size of an array at the 
start of a program. We would need to allocate the array's size dynamically. 


However, if you've tried it, you might have noticed that this doesn't work! 


Let's try and use theci n command to take in an array size from the user. Let's ask 
the user how big he wants his array and try to create one for him of that size: 


#include <iostream> 
using namespace std; 
int main() 


{ 


cout << "How big?" << endl; 
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int size: || try and use a variable for size.. 
cin >> size: || get size from user 
int array[ size ]; // get error: “unknown size" 


} 
We get the following error: 


error C2133: ‘array’ : unknown size 


The problem is that the compiler wants to allocate the size of the array. However, 
unless the variable size is marked const , the compiler will not be sure of its value at 
compile time. The C++ compiler cannot size the array at compile time, so it generates 
a compile time error. 


To þx this, we have to allocate the array dynamically (on the "heap"): 


#include <iostream> 
using namespace std; 
int main() 
{ 
cout << "How big?" << endl; 
int size; || try and use a variable for size.. 
cin >> Size: 
int *array = new int[ size ]; // this works 
// fill the array and print 
for( int index = 0; Index < size; index++ ) 


{ 
array[ index ] = index * 2: 
cout << array[ index ] << endl; 
} 
delete[] array; // must call delete[] on array allocated with 
// newl]! 
} 


So the lessons here are as follows: 


e Toallocatean array of some type (for example, i nt ) dynamically, you must 
use new i nt[number OfEl ementslnArray]. 


e Arrays allocated with new[ ] must be later deleted with del et e[ ] , otherwise 
you'll get a memory leak! (that's de! et e[ ] with square brackets! N ot regular 
delete). 
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Dynamic C-style arrays 
C-style arrays are a legacy topic, but they are still worth discussing since even 
though they are old, you might still see them used sometimes. 


The way we declare a C-style array is as follows: 


#include <iostream> 
using namespace std; 


int main() 
{ 
cout << "How big?" << endl; 
int size: || try and use a variable for size.. 
cin >> Size; 
// the next line will look weird.. 


int *array = (int*)malloc( size*sizeof(int) ); // C-style 
// fill the array and print 
for( int index = 0; Index < size; index++ ) 


{ 
array[ index ] = index * 2: 
cout << array[ index ] << endl; 
} 
free( array ); // must call free() on array allocated with 
|| malloc() (not delete[]!) 
} 


The differences here are highlighted. 


A C-style array is created using thema! | oc() function. The word malloc stands for 
"memory allocate". This function requires you to pass in the size of the array in bytes 
to create and not just the number of elements you want in the array. For this reason, 
we multiply the number of elements requested (size) by si zeof of the type inside 
the array. The size in bytes of afew typical C++types is listed in the following table: 


C++ primitive type sizeof (size in bytes) 


O SSS 


Memory allocated with the ma! | oc() function must later be released usingf ree(). 
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Summary 


This chapter introduced you to C and C++style arrays. In most of the UE4 code, you 
will usethe UE4 editor built in collection classes (TAr ray <T>). However, you need 
familiarity with the basic C and C+ style arrays to be a very good C++ programmer. 
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Now wewill really delve into UE4 code. At prst, it is going to look daunting. The UE4 
class framework is massive, but don't worry. The framework is massive, so your code 
doesn't have to be. You will pnd that you can get a lot done and a lot onto the screen 
using relatively less code. This is because the U E4 engine code is so extensive and 

well programmed that they have made it possible to get almost any game-related task 
done easily. Just call the right functions, and voila, what you want to see will appear 
on the screen. The entire notion of a framework is that it is designed to let you get the 
gameplay you want, without having to spend a lot of time in sweating out the details. 


Actors versus pawns 


In this chapter, we will discuss actors and pawns. Although it sounds as if pawns 
will be a more basic class than actors, it is actually the other way around. A UE4 
actor (theAct or class) object is the basic type of the things that can be placed in the 
UE4 game world. In order to place anything in the UE4 world, you must derive from 
theActor class. 


A Pawn IS an object that represents something that you or the computer's Ariibaal 
Intelligence (Al) can control on the screen. ThePawn class derives from theAct or 
class, with the additional ability to be controlled by the player directly or by an 

Al script. When a pawn or actor is controlled by acontroller or Al, itis said to be 
possessed by that controller or Al. 


Think of theAct or class as a character in a play. Your game world is going to 

be composed of a bunch of actors, all acting together to make the gameplay work. 
The game characters, N on-player Characters (N PCs), and even treasure chests will 
be actors. 
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Creating a world to put your actors in 


Here, we will start from scratch and create a basic level into which we can put our 
game characters. 


The UE4 team has already done a great job of presenting how the world editor 
can be used to create a world in UE4. | want you to take a moment to create your 
own world. 


First, create a new, blank UE4 project to get started. To do this, in the Unreal 
Launcher, click on the Launch button beside your most recent engine installation, 
as shown in the following screenshot: 


Engines 


4.4.3 


My Projects 4 


Marketplace 


Library 


BlankProject FirstPerson Flying 


UE4 Links 
AnswerHub 


a) Forums 


@ Roadmap 
ED Twitch Stream Vault a 





That will launch the Unreal Editor. The Unreal Editor is used to visually edit your 
game world. You're going to spend alot of time in the Unreal Editor, so please take 
your time to experiment and play around with it. 
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| will only cover the basics of how to work with the UE4 editor. You will need to let 
your creative juices yow, however, and invest some time in order to become familiar 
with the editor. 


To learn more about the U E4 editor, take a look at the G &ting 
< Started: Introduction to the U E4 Editor playlist, which is available at 
Q https://www. youtube.com playlist?!ist=PLZI v_NO_ 
Olgasd4l cOe9Cx9WHOBB/rxFl. 


Once you've launched the UE4 editor, you will be presented with the Projects 
dialog. The following screenshot shows the steps to be performed with numbers 
corresponding to the order in which they need to be performed: 


AL Unreal Project Browser 
Projects New Project 
First, choose a template to use as a starting point for your new project 


FÔ Blueprint g C++ 


~— 


A la 


First Rolling Side 
Person Scroller 


S~ 


a g ss Qz 


a 


i ` 
2D Side Third Top Down Twin Stick Vehicle Vehicle D 


Scroller Person Shooter Advanced 
Basic Code 


An empty project with some basic game framework code classes created. 


ne settings for your project. Don't worry, you can choose later or change these at any time in [Project Settings - Target Hardware] 


J. ae 


Desktop / Console Maximum Quality With Starter Content 


Finally, choose a location for your project to be stored 


Y:\Unreal Projects\ -- I GoldenEgg 


Name 





_ Create Project — 


Perform the following steps to create a project: 


1. Select the New Project tab at the top of the screen. 
2. Click on the C ++ tab (the second subtab). 
3. Then select Basic Code from the available projects listing. 
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4. Set the directory where your project is located (mine is YA Unreal Projects\ ). 
Choose a hard disk location with a lot of space (the pnal project will be 
around 1.5 GB). 


5. Name your project. | called mine GoldenEgg. 
6. Click on Create Project to bnalize project creation. 


Once you've done this, the UE4 launcher will launch Visual Studio. There will only 
be a couple of source bles in Visual Studio, but we're not going to touch those now. 
M ake sure that D evelopment Editor is selected from the Conbguration Manager 
dropdown at the top of the screen, as shown in the following screenshot: 


id | GoldenEgg - Microsoft Visual Studio (Administrator) 
FILE EDIT VIEW PROJECT BUILD DEBUG TEAM TOOLS TEST ARCHITECTURE ANALYZE WINDOW 4H Ae Config Manager 


iB ’ eI Š] pa P Local windows Debugger ~ Auto ~ [Development Editor 


DebugGame 


DebugGame Editor 
Develo e 


Solution Explorer Ix 


@ -200 sE 


Searcn Solutii Explorer (Ctri+ 


p~ Shipping 
a a ees Configuration Manager... 
4 [$] Goldenegg 
b j Config 
ò #& External Dependencies 
4 ra] Source 
4 Tal] Goldenegg 
> si) Resources 
c* GoldenEgg.Build.cs 
++ GoldenEgg.cpp 
GoldenEgg.h 
++ GoldenEggGamemode.cpp 
GoldenEggGamemMode . h 
c* GoldenEgg.Target.cs 
c* GoldenEggEditor.Target.cs 
A) GoldenEgg.uproject 
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Now launch your project by pressing Ctrl +F5 in Visual Studio. You will pnd 
yourself in the Unreal Engine 4 editor, as shown in the following screenshot: 


new - jA import g 
€+ ‘EH Game » StarterContent » Props » 


A 


>p 





The UE4 editor 


We will explore the U E4 editor here. We'll start with the controls since it is important 
to know how to navigate in Unreal. 


Editor controls 
If you've never used a 3D editor before, the controls can be quite hard to learn. 
These are the basic navigation controls while in edit mode: 

e Usethe arrow keys to move around in the scene 

e Press Page U p or Page D own to go up and down vertically 

e Left mouse click +drag it left or right to change the direction you are facing 


e Left mouse click +drag it up or down to dolly (move the camera forward and 
backward, same as pressing up/ down arrow keys) 
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e Right mouse click +drag to change the direction you are facing 
e Middle mouse click +drag to pan the view 
e Right mouse click and theW,A,S, and D keys to move around the scene 


Play mode controls 


Click on the Play button in the bar at the top, as shown in the following screenshot. 
This will launch the play mode. 


E = A zmr manr PE N O EE 


Save Content Marketplace Settings Blueprints Matinee Build Compile Hla E 





Once you click on the Play button, the controls change. In play mode, the controls 
are as follows: 
e TheW,A,S,andD keys for movement 
e Theleft or right arrow keys to look toward the left and right, respectively 
e The mouse's motion to change the direction in which you look 
e TheEsc key to exit play mode and return to edit mode 


What | suggest you do at this point is try to add a bunch of shapes and objects into 
the scene and try to color them with different materials. 


Adding objects to the scene 


Adding objects to the scene is as easy as dragging and dropping them in from the 
Content Browser tab. The C ontent Browser tab appears, by default, docked at the 
left-hand side of the window. If it isn't seen, simply select Window and navigate to 
Content Browser in order to make it appear. 
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A, Minter 
File Edit | Window | Help 
J” Modes $ Details 
=» Viewports 
| 7 ( Æ Build And Submit 


Search Clas 


= Layers 
w Levels 
Recently Pl v # Modes 


= Scene Outliner 


Basic ae 
A Sola liStics 


| Lights é > Toolbar 
® World Settings 


= 5 Content Browser = Content Browser | 


# Developer Tools j == Content Browser 2 


Visual 


Volumes eee i : 
& Blueprint Debugger == Content Browser 3 


All Classes 4@@ Class Viewer = Content Browser +4 
%. Device Profile Editor 





M ake sure that the Content Browser is visible in order to add objects to your level 


Next, select the Props folder on the left-hand side of the Content Browser. 


= Content Browser 


New~ Alimport a 


= Game » StarterContent » Props » a 


Search Folde p Filters ~ 


4m Game 
4 fm StarterConter 
| Architecture 


Sa Audio 
> 3 Blueprints Materials SM_Bush SM_Chair 
a HDRI 


O Materials 
A on S Di 
com 


is Shapes 3M_Corner ay, ? 
i Textures Frame a eee 


shuren SM_Lame 
een eiling sree) 


PSINA 


“Te 


Drag and drop things from the Content Browser into your game world 
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To resize an object, press R on your keyboard. The manipulators around the object 


will appear as boxes, which denotes resize mode. 





Press R on your keyboard to resize an object 


In order to change the material that is used to paint the object, simply drag and drop 
anew material from the Content Browser window inside the M aterials folder. 


= Content Browser 


New~ Alimport = 
"= Game + StarterContent + Materials + ‘b&b 


FE Search Folde O aiek each Materials a 


aBa Game 
4m StarterConter 
BS Architecture 
m Audio 
b E Blueprints 
a HDA 
eat’ 
b E Particles 
4m Props 
i Materials 
E Shapes 3 ; 
BE Textures jå ANNA 


M Metal M_Wletal 


Rust Steel 





Drag and drop a material from the Content Browser's Materials folder to color things with a new color 
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Materials are like paints. You can coat an object with any material you want by 
simply dragging and dropping the material you desire onto the object you desire it 
to be coated on. Materials are only skin-deep: they don't change the other properties 
of an object (Such as weight). 


Starting from scratch 


If you want to start creating a level from scratch, simply click on File and navigate to 
N ew Level..., as shown here: 


u Seer 


File | Edit Window Help 
Load and Save 
A 
BB Open Level... 
Mm Save 
p Save As... 
SÌ Save All Levels 
>% Open Asset... 


™@ Save All 


Connect To Source Control... 





You can then select between D efault and Empty Level. | think selecting Empty Level 
IS agood idea, for the reasons that are mentioned later. 


AL New Level 


Bajak 
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The new level will be completely black in color to start with. Try dragging and 
dropping some objects from the C ontent Browser tab again. 


This time, | added aresized shapes/ box for the ground plane and textured it with 


moss, a couple of Props/ SM_ Rocks, Particles/ P_Fire, and most importantly, 
a light source. 


Be sure to save your map. Here's a snapshot of my map (how does yours look?): 





If you want to change the default level that opens when you launch the editor, 
go to Project Settings | Maps & M odes; then you will see a G ame Default M ap 
and Editor Startup M ap setting, as shown in the following screenshot: 


AU 


VProjeee seninde 


Project Project - Maps & Modes 


$a These settings are saved in DefaultEngine.ini, which is currently writable 


es G <> ~ 
4 Default Maps 
Game Default Map /Game/Maps/campfire |w 
Editor Startup Map /Game/Maps/campfire |». | 
¥ 





Adding light sources 


N ote that if your scene appears completely black, it is possible that you forgot to put 
a light source into It. 
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In the previous scene, the P_ Fire particle emitter acts as a light source, but it only 
emits a small amount of light. To make sure that everything appears well-lit in your 
scene, you should add alight source, as follows: 


1. Goto Window and then click on M odes to ensure that the light sources 
panel is shown: 


AL AE 
File Edit | Window | Help 
J Mades 7 Details 
se Viewports 
eo’ f J Build And Submit 


= Layers 


we Levels 


Recently PLM - 





Al Mines? 
File Edit Window Help 


fF Modes 


T eaecen t= Directional Light 


Basic 

Lights Point Light 

Visual PointLight 
Spot Light 

BSP 


Volumes =A Sky Light 


All Classes 





3. Select the lightbulb and box icon (it looks like a mushroom, but It isn't). 
4. Click on Lights in the left-hand side panel. 
5. Select the type of light you want and just pull it into your scene. 


If you don't have a light source, your scene will appear completely black. 
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Collision volumes 


You might have noticed that, so far, the camera just passes through all the scene 
geometry, even in play mode. That's not good. Let's make it such that the player can't 
just walk through the rocks In our scene. 


There are a few different types of collision volumes. Generally, perfect mesh-mesh 
collisions are way too expensive to do at runtime. Instead, we use an approximation 
(a bounding volume) to guess the collision volume. 


Adding collision detection for the objects editor 


The prst thing we have to do is associate a collision volume with each of the rocks in 
the scene. 


Wecan do this from the UE4 editor as follows: 


1. Click on an object in the scene for which you want to add a collision volume. 


2. Right-click on this object in the Scene O utliner tab (the default appears 
on the right-hand side of the screen) and select edit, as shown in the 
following screenshot: 


Scene Outiner 


ah 


+ Avatar 
BP_LightStage 
Player Start *layerStart 
pY PostProcessVolumel PostProcess 
‘7 SM_AssetPlatiorm StaticMeshaA 
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= 
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Wo 
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Edits the asset associated with the selected actor 





| You will pnd yourself in the mesh editor. | 
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3. Ensurethat the collision volume is highlighted, at the top of the screen: 


SSM ROOK 


Help Search For Help 


dit sset y 
z 4 (1!) me = Dane aes = ofl 
ae = wI i 
tte : AR = y d | 
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Toggles display of the simplified collision mesh of the static mesh, if one has been assigned 


Element 0 





4. Goto the Collision menu and then click on Add Capsule Simpliped 
Collision: 


File Edit Asset Mesh || Collision ) Window Help 


F | Add Sphere Simplified Collision re z 
= A ‘S) Add Capsule Simplified Collision CH i E 

Add Box Simplified Collision 
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5. The collision volume, when added successfully, will appear as a bunch of 
lines surrounding the object, as shown in the following images: 





The default collision capsule (left) and manually resized versions (right) 


6 Youcanresize(R), rotate (E), move (W ), and change the collision volume as 
you wish, the same way you would manipulate an object in the UE4 editor. 


7. When you're done with adding collision meshes, try to click on Play; you will 
notice that you can no longer pass through your collidable objects. 


Adding an actor to the scene 


Now that we havea scene up and running, we need to add an actor to the scene. 
Let's prst add an avatar for the player, complete with a collision volume. To do this, 
we'll have to inherit from aUE4GameFramework class. 


Creating a player entity 


In order to create an onscreen representation of the player, we'll need to derive from 
theCharacter classin Unreal. 


Inheriting from UE4 GameFramework classes 


UE4 makes it easy to inherit from the base framework classes. All you have to do is 
perform the following steps: 


1. Open your project in the U E4 editor. 
2. Goto File and then select Add Code to Project... 
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u 
File | Edit Window 
Load and Save 
tI New Level... 
B open Level... 
my Save 
B Save As... 
SÌ Save All Levels 
$+ Open Asset... 
m Save All 
Choose Files to Save... 
Connect To Source Control... 
Project 
W New Project... 
Y Open Project... 


E Package Project 
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ider 
tad Stair 


b Adds C++ code to 


Navigating to File] Add Code To Project... will allow you to derive from any of the U E4 GameFramework 


classes 


3. From here, choose the base class you want to derive from. You have 
Character, Pawn, Actor, and so on, but for now, wewill derive from 


Character: 
AL 


Add Code 


Choose Parent Class 


You are about to add a C++ source code file. To compile these files you must have Visual Studio 2013 installed. 


> Pawn 


Pawn is the base class of all actors that can be possessed by players or Al 


@ Actor 


Actor is the base class for an Object that can be placed or spawned in a level. 


@ Player Camera Manager 


Defines the point of view of a player in world space. 


@ Player Controller 


Selected Class Character 
Selected Class Source Characterh 





Ø Show All Classes 


Select the UE4 class you want to derive from 
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4. Click on Next > to get this dialog box, where you name the class. | named my 
player's cClassAvatar. 


AL E 


Name Your New Character 


Enter a name for your new class. Class names may only contain alphanumeric characters, and may not contain a space. 
When you click the “Create” button below, a header (.h) file and a source (.cpp) file will be made using this name. 


<r (TTT 
Path C:/Users/user/Documents/Unreal Projects/MyProject/Source/MyProject/ Choose Folder 


Header File C:/Users/user/Documents/Unreal Projects/MyProject/Source/MyProject/Avatar.h 


Source File C:/Users/user/Documents/Unreal Projects/MyProject/Source/MyProject/Avatar.cpp 


create cass Cancel 





5. Finally, click on Create Class to create the class in code, as shown in the 
preceding screenshot. 


Let UE4 refresh your Visual Studio project when it asks you. Open the new 
Avatar. h blefrom the Solution Explorer. 


The code that U E4 generates will look a little weird. Remember the macros that | 
suggested you avoid in Chapter 5, Functions and M acros. The UE4 code uses macros 
extensively. These macros are used to copy and paste boilerplate starter code that lets 
your code integrate with the UE4 editor. 


The contents of theAvat ar. h ple are shown in the following code: 


#pragma once 

|| Avatar.h code file 

#include "GameFramework/ Character. h" 

#include "Avatar. generated. h" 

UCLASS() 

class MYPROJ ECT API AAvatar : public ACharacter 


GENERATED UCLASS BODY() 
ie 
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Let's talk about macros for a moment. 


TheUCLASS() macro basically makes your C++ code class available in the UE4 
editor. TheGENERATED UCLASS BODY() macro copies and pastes code that U E4 
needs to make your class function properly as a UE4 class. 


For UCLASS() andGENERATED UCLASS BODY() , you don't truly 
< need to understand how U E4 works its magic. You just need to make 
Q sure that they are present at the right spot (where they were when 
you generated the class). 


Associating a model with the Avatar class 


Now we need to associate a model with our character object. In order to do this, 
we need a mode! to play with. Fortunately, there is a whole pack of sample models 
available from the U E4 marketplace for free. 


Downloading free models 


To create the player object, we'll download the Animation Starter Pack ble (which is 
free) from the M arketplace tab. 


T) MARKETPLACE submit content 


L A Pery an 
Eo bill.sherif@gmail.com > i 
j 7 - "a \ a ’ oa > 
ae | Yy ; r ) - 
= ` SN 
7 x y ae tS 


ad 


Military Character Zombie Crew Bundle Sci Fi Creatures Pack Sci Fi Robots Pack 
Dark >60. 01 ¢an 00 $50.00 
Å 20 


E Ce j xs w Á | aN 
Marketplace a 4 aN 
@ Library P ea | 
; oe 4 Á 


Low Poly Skeleton Military Character Animation Starter 
Crew Silver Pack 
¢ if { è eC { ‘ala Ava 4s 


UE4 Links 
AnswerHub 
@) Forums Mixamo Animation 
@ Roadmap Pack 
E Twitch Stream i 





From the Unreal Launcher, click on Marketplace and search for Animation Starter Pack, which is free at the 
time of writing this book 
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After you've downloaded the Animation Starter Pack ble, you will be able 
to add it to any of the projects you've previously created, as shown in the 
following screenshot: 


Marketplace 


Library 


Vaultz es E 


An ation Starter Pack | Content Examples 
10:7 MB =~ | | 3.9GB 


GameTextures Material Pack Lightroom: interior day light 


686.7 MB sg 69.6 MB 
UE4 Links 


AnswerHub 


@) Forums Doa a Tappy Blesi 
> Roadmap s A 
E Twitch Stream : 





When you click on Add to project under Animation Starter Pack, you will get this 
pop up, asking which project to add the pack to: 


FirstPerson 


i nanoia 


TopDown 





Simply select your project and the new artwork will be available in your 
Content Browser. 
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In general, it is considered a bad practice to hardcode your assets into the game. 

H ardcoding means that you write C+ code that specibes the asset to load. However, 
hardcoding means the loaded asset is part of the pnal executable, which will mean 
that changing the asset that is loaded wouldn't be modipable at runtime. This isa 
bad practice. It is much better to be able to change the asset loaded during runtime. 


For this reason, we're going to use the UE4 blueprints feature to set up the model 
mesh and collision capsule of our Avat ar class. 


Creating a blueprint from our C++ class 


1. Thisis really easy. Open the Class Viewer tab by navigating to Window 
and then clicking on Class Viewer, as shown here: 


File Edit 
J” Modes 


Recently Pl v“ 
; P 

Basic 

Lights 

Visual 

BSP 

Volumes 


All Classes ¥ 


Window 





F camp frer 


Help 

® Details 

S: Viewparts 

Æ Build And Submit 
= Layers 

Wè Levels 

# Modes 

f= Scene Outliner 
Wi Statistics 

¥ Toolbar 

®@ World Settings 


== Content Browser 

$e Developer Tools 

&* Blueprint Debugger 
i. 

$| Device Profile Editor 
©} Message Log 

E output Log 

=D Undo History 
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2. \IntheClass Viewer dialog, start typing in the name of your C++ class. If you 
have properly created and exported the class from your C++ code, it will 
appear, as shown in the following screenshot: 


= Content Browser W Class Viewer 


Filters 


Create /Game/Unsorted/BP_Avatar 


) 


Open C++ Header... 


Create New C++ Class.. gg 
i Search Folders pD 
> Sa Engine 
l i AnimStarterPack 
b fi StarterContent 





v If your Avatar class does not show up, close the 
editor and compile/ run the C++ project again. 


3. Right-click on the class that you want to create a blueprint of (in my case, 
it's my Avatar class). 


Name your blueprint something unique. | called my blueprint BP_ Avatar. 


5. Now, open this blueprint for editing, by double-clicking on BP_ Avatar 
(it will appear in the Class Viewer tab after you add it, just under Avatar), 
as shown in the following screenshot: 


== Content Browser w Class Viewer 





[ 162 ] 


www.it-ebooks.info 


Chapter 8 


6. You will be presented with the blueprints window for your new BP_ Avatar 
object, as shown here: 


u EPN 
File Edit Asset View Debug Window Help | | INECIOUE Search For Help 
si || O a8 5 z7 : l — oe \ ff 
ke E , ze bam No debug object selected ~ iE — (MI DY=iga10] tmp Pte EA wm) Ce) 
Compile Saye FindinCB Search Blueprint Props Play Debug Filter a 


“s= (fy Blueprint Construction Script == Event Graph 
y, p r I p 


+, + 


C: Right-Click to Create New Nodes. 


a. EventGraph 
PUNRCTIONS 


> 


*rf ConstructionScript 
Jverridable Functior 


4Pawn 
4Character 
4 Internal Events 
Èf CanJump 
§ Show inherited variables 


a Details 





> From this window, you can attach a mode! to theAvat ar class visually. 
Again, this is the recommended pattern since artists will typically bethe 
ones setting up their assets for game designers to play with. 
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7. Toset up the default mesh, click on the D efaults button at the top. Scroll 
down through the properties until you come across M esh. 


AL ia” BP Avatar 


File Edit Asset View Debug Window 
7 
Compile Save Findin CB 


"Editing defaults 


Search 


4 Mesh 


: 2 
£ 
Skeletal Mesh HeroTiPP SA E O ike) 


8. Click on the dropdown and select H eroT PP for your mesh, as shown in the 
preceding screenshot. 


9. If HeroTPP doesn't appear in the dropdown, make sure that you download 
and add the Animation Starter Pack to your project. Alternatively, you can 
add the yellow TutorialTPP model to your project if you select Show Engine 
Content under View Options: 





Editing defaults 


4 Transform Edit 
4 Mesh Copy 
Location w 
Rotation v Clear 
Scale v 


4 CapsuleComponent 


Scale vw 10 efaultSkeletalMesh 


Skeletal Mesh 


Mobility E Static E 
4 Animation SkeletalCube 
REANA ree 
Animation Mode = Lei 
utorial_DM 
Anim to Play R_Jog x = Destructible Mesh 


| c 
TutorialTP 
Looping 


Playing 


Initial Position 


4 Mesh 


Skeletal Mesh 


1 
4 Physi Columns 
ysics 
4 Mesh 
Ø Public View 





A Show Plugin Content 
O eee 


Parte 3 
3 CA Show Engine Content 
a= p “ — r 
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10. What about the collision volume? Click on the Components tab in the 
blueprint editor for your avatar: 


ag BPM eE eter 


Edit Asset View Debug Window | My Character.h & 


© Fe i> =v Defaults = Component 


-— + 
Compile Save FindinCB Blueprint Props Simulation 
A Components 


@ Add Component 
e Class Asset 
Charact 
4° [ROOT] 
Arrow 
Mesh HeroTPP 





If your capsule doesn't encapsulate your model, adjust the model so that it fits 


If your model ended up like mine, the capsule is off the mark! 
J Weneed to adjust it. 
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11. Click on the blue Avatar model and press the W key. Movehim down until 
he pts inside the capsule. If the capsule isn't big enough, you can adjust its 
size in the D etails tab under Capsule H eight and Capsule Radius, as shown 
in the following screenshot: 


Æ Components 


& Add Component ~ 
e Class 


CharacterMovement 


ArrowComponent 
Mesh HeroTPP 


2) Details 


seach DD o- 


4 Shape 
ecm 102.139107 RAN o 


v 


4 Physics 


Simulate Ph, § 


Ea cof bem Default v 
v 


4 Collision 
Simulation G E 


Generate Ov 





You can stretch your capsule by adjusting the Capsule H eight property 


12. Now, we're ready to add this avatar to the game world. Click and drag your 
BP_A vatar model from the Class Viewer tab to your scene in the U E4 editor. 


[166 ] 


www.it-ebooks.info 


Chapter 8 





Our Avatar class added to the scene, in a T-pose 


The pose of Avatar is called the T-pose. Animators often leave their characters in 

this default pose. Animations can be applied to the character in order to make them 
change this default pose to something more interesting. You want him animated, you 
say! Well, that's easy. 


Under the D efaults tab in the blueprint editor, just above M esh, thereis an 
Animation section where you can select the active animation on your M esh. 
If you wish to use a certain animation asset, simply click on the drop-down 
menu and choose the animation you desire to show. 


A better thing to do, however, is to use a blueprint for the animation. This way, 
an artist can properly set the animation based on what the character is doing. If 
you select Use Animation Blueprint from Animation M ode and then select ASP_ 
HeroTPP_AnimBlueprint from the drop-down menu, the character will appear 
to behave much better in the game, because the animation will be adjusted by the 
blueprint (which would have been done by an artist) as the character moves. 


44 Animation 


Animation Mode Use Animation Blueprint + 
Anim Blueprint Generated Class ASP_HerolF + RORE 2 


al Mesh @ None 
® Animinstance 


@® AnimPreviewinstance 
Skeletal Mesh 


© AnimSingleNodelnstance 
@ ASP_HeroTPP_AnimBlueprint 
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We can't cover everything here. Animation blueprints are covered in 
Chapter 11, M onsters. If you're really interested in animation, it also 
< wouldn't be a bad idea to sit through a couple of Gnomon Workshop 
Q tutorials on IK, animation, and rigging, such as Alex Alvarez's Rigging 
101 classathttp://www.thegnomonworkshop. com/store/ 
product/768/Rigging-101. 


One more thing: let's make the camera for the Avatar appear behind it. This will give 
you a third person's point-of-view, which will allow you to see the whole character, 
as shown in the following screenshot with the corresponding steps: 


uU aaperyee 


File Edit Asset View Debug Window Help Parent class: Avatar.h ‘Search For Help 
V/s (= i He HETER a Components: ) 
Compile Save Fmdin CB 


Fe Components 


@ Add Component ~ 


earch Components 
aT 
% Audio 
* Skeletal Mesh 
sy Static Mesh 
Al 
© AlPerception 
© Pawn Noise Emitter 
®© Pawn Sensing 
Lea Mera 
ty Camera 


he 


Ley Spring Arn Represents a camera viewpoint and settings, such as projection type, field of view, and post-process 





1. IntheBP_Avatar blueprint editor, click on the Components tab. 

2. Click on Add Component. 

3. Choose to add a Camera. 
A camera will appear in the viewport. You can click on the camera and move It 
around. Position the camera so that it is somewhere behind the player. M ake sure that 


the blue arrow on the player is facing the same direction as the camera. If it isn't, rotate 
the Avatar model mesh so that it faces the same direction as its blue-colored arrow. 
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The blue-colored arrow on your mode! mesh indicates the forward direction for the model mesh. Make sure 
that the camera's opening faces the same direction as the character's forward vector 


Writing C++ code that controls the 
game's character 


When you launch your UE4 game, you might notice that the camera is a default, 
free-yying camera. What we will do now is make the starting character an instance 
of our Avatar class and control our character using the keyboard. 


Making the player an instance of the Avatar 
class 


In the Unreal Editor, create a subclass of Game M ode by navigating to File| Add 
Code To Project... and selecting Game M ode. | named mine GameM odeG oldenEgg. 


Choose Parent Class == === = Name Your New Game Mode 


You are about to add a C++ source code file. To compile these files you must have Visual Studio 2013 installed. ; R 
Enter a name for your new class. Class names may only contain alphanumeric 


When you click the “Create” button below, a header (.h) file and a source (.cpp) 
@ Player Controller 


PlayerControllers are used by human players to control Pawns. 


Name GameModeGoldenEgg 
Path Y:/Unreal Projects/GoldenEgg/Source/GoldenEgg/ 
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The UE4 GameM ode contains the rules of the game and describes how the game is 
played to the engine. We will work more with our Game Mode class later. For now, 
we need to subclass it. 


Recompile your project from Visual Studio, so you can create a 

GameM odeG oldenEgg blueprint. Create the GameM ode blueprint by going 

to the Blueprints icon in the menu bar at the top, clicking on GameM ode, and 
then selecting + Create | GameM odeG oldenEgg (or whatever you named your 
GameM ode subclass in step 1). 


A ba ee | ial a si ka oF ba z ka Ss ka 


Blueprints Matinee Build Compile Play Launch 


Lirvel Blueprints 


A Open Level Blueprint 


, + 
Select GameMode Class 
© GameMode 
© GameModeGoldenEgg 
@ KenceToTrexure_Game 


GameMode: Not overridden! > 
Class Blueprints 


E New Class Blueprint... 





1. Name your blueprint; | called mine BP_GameM odeG oldenEgg, as shown in 
the following screenshot: 


ail Create GameMode Blueprint 


Search Folders 





d Game 
b | AnimStarterPack 
BE Character 
? Zi DemoRoom 
b E ExampleContent 
> E StarterContent 
Ge Unsorted 


Ele BP_GameModeGoldenEgg 
a 





2. Your newly created blueprint will open in the blueprint editor. If it doesn't, 
you can open the BP_GameM odeG oldenEgg class from the Class V iewer tab. 
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3. Select your BP_Avatar class from the D efault Pawn Class panel, as shown in 
the following screenshot. The D efault Pawn Class panel is the type of object 
that will be used for the player. 


AL MA EP iGameModeGoldenegg 


File Edit Asset View Debug Window Help Golden Egg Game Mode 


ro 


. ? : + 
Compile Save Find in CB 


Editing defaults 


4 Game Mode 


Default Pawn Class | BP_Avatar~ [RS QO + * 2 


z Search 
HUD Class 


Player Controller Class 
Spectator Class 


Game State Class 


4 Tags 


Tags SpectatorPawn 


2088 Ofer 





4. Now, launch your game. You can see a back view as the camera is placed 
behind the place, as shown here: 





You'll notice that you can't move. Why is that? The answer is because we haven't set 
up the controller inputs yet. 
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Setting up controller inputs 
1. Tosetup controller inputs, go to Settings | Project Settings...: 


r a KS B 


settings Blueprints Matinee Build 


specific Settings 


World Settings 





2. Next, in theleft-hand side pane, scroll down until you see Input 
under Engine. 


‘UW eee 
Engine Engine - Input 
Audio Input settings including default imputa ction and 2 15 bindings 
"ia These settings are saved in Defaultinput-ini, which is currently writable) 


Input 4 Bindings 


7 i Action Mappings 
Navigation Mesh ek appings E O 


a Axis Mappings + Ù 


Pi Forward + x 


FE Strafe + X 


T Crole @ x 
saie SD x 


Platforms = 





3. On theright-hand side, you can set up some Bindings. Click on the small 
arrow next to Axis M appings in order to expand it. Add just two axis 
mappings to start, one called Forward (connected to the keyboard letter W) 
and one called Strafe (connected to the keyboard letter D ). Remember the 
names that you set; we will look them up in C+ code in just a moment. 


4. Closethe Project Settings dialog. Now, open your C+ code. 
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In theAvat ar. h constructor, you need to add three member function declarations, 
as shown here: 


UCLASS() 
class GOLDENEGG API AAvatar : public ACharacter 


{ 
GENERATED UCLASS BODY() 


|| New! These 3 new member function declarations 
|| they will be used to move our player around! 


void SetupPlayerlnputComponent(class Ul nput Component * 
Input Component) override; 


void MoveForward( float amount )}; 
void MoveRight( float amount ); 


if 


Notice how the prst member function we're adding (Set upP! ayer! nput Component ) 
isan override of a virtual function. SetupPl ayerl nput Component isa virtual 
function in the AP awn base class. 


IntheAvatar.cpp ble, you need to put the function bodies. Add the following 
member function debnitions: 


void AAvatar::SetupPlayerlnputComponent(class Ul nput Component * 
Input Component) 


{ 
check(Input Component); 


Input Component->BindAxis( "Forward", this, 
&AAvatar:: MoveForward); 


Input Component->BindAxis("Strafe", this, &AAvatar:: MoveRi ght) : 
} 


This member function looks up the Forward and Strafe axis bindings that we just 
created in Unreal Editor and connects them to the member functions inside thet hi s 
class. Which member functions should we connect to? Why, we should connect to 
AAvatar:: MoveForward andAAvatar:: MoveRi ght . Here are the member function 
depnitions for these two functions: 


void AAvatar::MoveForward( float amount ) 


{ 
|| Don't enter the body of this function if Controller is 
|| not set up yet, or if the amount to move is equal to 0 
if( Controller && amount ) 


FVector fwd = GetActorForwardVector(): 
|| we call AddMovementIi nput to actually move the 
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|] player by amount’ in the ‘fwd direction 
AddMovementI nput(fwd, amount); 
} 
} 


void AAvatar::MoveRight( float amount ) 


{ 


if( Controller && amount ) 


{ 
FVector right = GetActorRightVector(): 


AddMovementI nput(right, amount); 


} 
} 


TheControl!ler object and theAddMovement!nput functions are 
RS. deþned in theAPawn base class. SincetheAvat ar class derives from 
Q AChar acter, which in turn derives from AP awn, we get free use of 
all the member functions in the base class AP awn. Now do you see the 
beauty of inheritance and code reuse? 


Exercise 
Add axis bindings and C++ functions to move the player to the left and back. 


Here’ ahint: you only need to add axis bindings if you realize 
7 going backwards is only the negative of going forward. 


Solution 
Enter two extra axis bindings by navigating to Settings | Project Settings... | Input, 
as shown here: 
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timnas, InNcuCING default mput actial 


Action Mappings + D 


a Axis Mappings + D 


Engine PA Forwara Ex 
a Scale (NS) x 
ED EE: &< EDN x 
re Strafe + X 
ED Scale SIDI x 
ba 


Navigation Mesh 





Scale the S and A inputs by -1.0. This will invert the axis. So pressing the S key in the 
game will movethe player forward. Try it! 


Alternatively, you can debne two completely separate member functions in your 
AAvatar Class, as follows, and bind theA and S keystoAAvatar:: Moveleft and 
AAvatar:: MoveBack, respectively: 


void AAvatar::MoveLeft( float amount ) 


{ 


if( Controller && amount ) 


{ 
FVector left = -GetActorRightVector()}: 


AddMovementI nput(left, amount); 


} 


void AAvatar::MoveBack( float amount ) 


{ 


if( Controller && amount ) 


{ 


FVector back = -GetActorForwardVector(); 
AddMovementI nput( back, amount); 


} 
} 
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Yaw and pitch 


We can change the direction in which the player looks by setting the yaw and pitch 
of the controller. 


All we have to do here Is add in new axis bindings for the mouse, as shown in the 
following screenshot: 


4 Bindings 
. Action Mappings = {jj 
Engine 


Audio 


a Axis Mappings #- gj 
PE Forward + x 
Scalp x 
cae x 


Pe Strafe + X 


FE Yaw + X 
P Pitch E T 


io Mousey o r a = 
F 





From C+, you need to add in two new member function declarations toAAvatar.h: 


void Yaw( float amount ); 
void Pitch( float amount )}; 


The bodies of these member functions will go in theAAvatar. cpp ble 


void AAvatar::Yaw( float amount ) 


{ 
AddControllerYawlnput(200.f * amount * Get Wor! d()- 
>Get Del taSeconds()); 


} 


void AAvatar::Pitch( float amount ) 


{ 
AddControllerPitchIl nput(200.f * amount * Get Wor! d()- 
>Get Del taSeconds()); 


} 
Then, add two linestoSetupPl ayer!l nput Component : 


void AAvatar::SetupPlayerl nput Component(class Ul nput Component * 
Input Component ) 
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// .. as before, plus: 
InputComponent->BindAxis("Yaw', this, &AAvatar:: Yaw); 
InputComponent->BindAxis("Pitch", this, &AAvatar:: Pitch); 


} 


Here, notice how I've multiplied thea mount values in they aw and Pi tch functions 
by 200. This number represents the mouse's sensitivity. You can (Should) add af | oat 
member to theAAvat ar classin order to avoid hardcoding this sensitivity number. 


Get Worl d()->Get Del taSeconds() gives you the amount of time that passed 
between the last frame and this frame. It isn't alot: Get Del taSeconds() should be 
around 16 milliseconds (0.016 s) most of the time (if your game is running at 60 fps). 


So, now we have player input and control. To add new functionality to your Avatar, 
this is all that you have to do: 


1. Bind your key or mouse actions by going to Settings | Project Settings | 
Input. 


2. Add a membe function to run when that key is pressed. 


3. AddalinetoSetupPl ayer! nput Component , connecting the name 
of the bound input to the member function we want to run when that 
key is pushed. 


Creating non-player character entities 


So, we need to create a few N PCs (non-playable characters). N PCs are characters 
within the game that help the player. Some offer special items, some are shop 
vendors, and some have information to give to the player. In this game, they will 
react to the player as he gets near. Let's program in some of this behavior. 


First, create another subclass of Character. In the UE4 Editor, go to File | Add Code 
To Project... and choose the Character class from which you can make a subclass. 
Name your subclass NPC. 


Now, edit your code in Visual Studio. Each NPC will havea message to tell the 
player, soweadd in aUPROPERTY() FString property to theNPC class. 


FStringsareUE4's version of C+#s <string> type When 
< programming in U E4, you should usetheF Stri ng objects over C+ 
Q STL'sstri ng objects. In general, you should preferably use U E4's 
built-in types, as they guarantee cross-platform compatibility. 
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How to add the UPROPERTY() FString property to theNPC class is shown in the 
following code: 


UCLASS() 

class GOLDENEGG_API ANPC : public ACharacter 

{ 
GENERATED UCLASS BODY() 
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = 
Collision) 
TSubobj ect Ptr<class USphereComponent> ProxSphere: 
|| This is the NPC's message that he has to tell us. 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
NPCMessage) 
FString NpcMessage; 
|| When you create a blueprint from this class, you want to be 
// able to edit that message in blueprints, 
|| that's why we have the EditAnywhere and BlueprintReadWrite 
|| properties. 


} 


Notice that we put theEdi t Anywhere and Bl uepri nt ReadWri te properties into the 
UPROPERTY macro. This will make theNpc Message editablein blueprints. 


Full descriptions of all the U E4 property specibers are available 
athttps://docs.unrealengine.com|latest/INT/ 

Programmi ng/UnrealArchitecture/Reference/ Properties/ 
index.html. 


Recompile your project (as we did for theAv at ar class). Then, go to the Class 
Viewer, right click on your NPC class, and create a blueprint from it. 


Each NPC character you want to create can be a blueprint based off of the NPC class. 
Name each blueprint something unique, as we'll be selecting a different model mesh 
and message for each NPC that appears, as shown tn the following screenshot: 


= Content Browser @@ Class Viewer 
Filters View 

NPC 

4@ Actor 


43 Pawn - . 
Create /Game/Blueprints/ 


ae: 
4% Character 


ay ae Alusanrint- filename 
F NPCA Blueprint Filename 


= 
i BP_NPC_Owen 
Open C++ Header... 
Blueprint Path 


Create New C++ Class... TSE PES 
ore arch Folders 
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N ow, open the blueprint, select skeletal mesh from the Add Components, and adjust 
the capsule (as we did for BP_Avatar). You can also change the material of your new 
character so that he looks different from the player. 


A Components 


& Add Component ~ 


* Class 


Copy 


CharacterMovement Clear 
d` [ROOT] CapsuleCompc — 
ArrowComponent : ai 
aa Search Assets 
nan | 3dParticleOpacity_Mat 
proxSphere | Ser Nakana] 
gE 3dFarticle0pacityinstance 
= Material Instance 
AdvancedFlag 
Material 
AlphaBrushMaterial 
Material 
F ; AlphaBrushMaterial_Smooth 
i Details 
AmbientOcclusion 
Material 
AntiAliasedTextMaterialTranslucent 
4 Rendering Material 


4 Materials | 1 elements BackgroundMaterial 
405 items @ View Options + 


* O + Y 


Materials 
Visible 


Hidden in Ga @ 





Change the material of your character in your mesh's properties. Under the Rendering tab, click on the +icon to 
add anew material. Then, click on the small capsule-shaped item to select a material to render with. 
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In the D efaults tab, search for the Npc Message property. This is our connection 
between C++ code and blueprints: because we entered aUPROPERTY() function on 
theFString NpcMessage variable, that property appears editable within UE4, as 


shown in the following screenshot: 


‘U aenreorer 


File Edit isset View Debug Window Hea 
= i) A ~= : j l E cil | F i qi f Ezy | A | fi | B. l | 
Compile Save FindinCB 


Editing defaults 
jesse $$$ XY o- 


4NPCMessage 





Now, drag BP_NPC_Owen into the scene. You can create a second or third character 
as well, and be sureto give them unique names, appearances, and messages. 


= Content Browser w Glass Viewer 


Filters View 
NPC 
FE Actor 

4. Pawn 


a Character 


gaocagap 





I've created two blueprints for NPCs based on the NPC base classes, BPN PC_Justin and BP_NPC_Owen. 
They have different appearances and different messages for the player. 
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Justin and Owen in the scene 


Displaying a quote from each NPC 
dialog box 


To display a dialog box, we need a custom (heads-up display) HUD. In the UE4 
editor, go to File| Add Code To Project... and choose the HUD class from which the 
subclass is created. Name your subclass as you wish; I'venamed mine My HUD. 


After you have created the My HUD class, let Visual Studio reload. We will make some 
code edits. 


Displaying messages on the HUD 


Inside theAMy HUD class, we need to implement the Dr awHUD( ) function in order to 
draw our messages to the HUD and to initialize a font to draw to the HUD with, 
as shown in the following code: 


UCLASS() 

class GOLDENEGG API AMyHUD : public AHUD 

{ 
GENERATED UCLASS BODY() 
// The font used to render the text in the HUD. 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = HUDFont) 
UFont* hudFont; 
// Add this function to be able to draw to the HUD! 
virtual void DrawHUD() override; 
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The HUD font will be set in a blueprinted version of the A My HUD class. The 
Dr awHUD( ) function runs once per frame. In order to draw within the frame, 
add a function to theAMy HUD. cpp ple: 


void AMyHUD: : Dr awHUD( ) 
{ 

// call superclass DrawHUD() function first 
Super: : DrawHUD(); 
|| then proceed to draw your stuff. 
|| we can draw lines.. 
DrawLine( 200, 300, 400, 
// and we can draw text! 


Drawlext( "Greetings from Unreal!", 
FVector2D( 1, 1), FColor:: White ); 


500, FlinearColor:: Blue ); 


FVector2D( 0, 0), hudFont, 


} 


Wait! We haven't initialized our font yet. To do this, we need to set it up in 
blueprints. Compile and run your Visual Studio project. Once you are in the editor, 
go to the Blueprints menu at the top and navigate to GameM ode | HUD | + Create 
| MyHUD. 
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Creating a blueprint of the MyHUD class 
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| called mineBP_ MyHUD. EditBP_ MyHUD and select a font from the drop-down menu 
under HUD Font: 


Ua EPLMVHUDe 


File Edit Asset View 


Window AAMA Search For Help 


_ a, %, F E ee TAE TON Nu 7 Fs ETE 
_ 


Debug Helfarent class 


F 

fo Si A 
Compile Save  Fmdin CE 
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Clear 
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EE Font 
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| selected RobotoDistanceField for my HUD font 


Next, edit your Game M ode blueprint (BP_GameM odeG oldenEgg) and select your 
new BP_MyHUD (not My HUD class) for the HUD Class panei: 
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Test your program by running it! You should see text printed on the screen. 


Soins frai» Unrgal! 
í 
U = 
— S i > 





Using TArray<Message> 


Each message we want to display for the player will havea few properties: 


e AnFString variable for the message 
e Afloat variable for the time to display it 
e AnFColor variable for the color of the message 


So it makes sense for us to write a littlest ruct function to contain all 
this information. 


Atthetop of My HUD. h, insert the following struct declaration: 


Struct Message 


{ 

FString message: 

float time; 

FColor color; 

Message() 

{ 
// Set the default time. 
time = 5.f; 
color = FColor:: White; 

} 

Message( FString iMessage, float iTime, FColor iColor |} 

{ 
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message = | Message; 
time = | Time: 
color = 1 Color: 


An enhanced version of theMes sage structure (with a background 


color) is in the code package for this chapter. We used simpler code 
: here so that it'd be easier to understand the chapter. 


Now, insidetheAMy HUD class, we want to add aTArray of these messages. A TArray 
is aUE4-debned special type of dynamically growable C++ array. We will cover the 
detailed use of TArray in the next chapter, but this simple usage of TArray should 
be a nice introduction to garner your interest in the usefulness of arrays in games. 
This will be declared aSTArray<Message>: 


UCLASS() 
class GOLDENEGG API AMyHUD : public AHUD 
{ 
GENERATED UCLASS BODY() 
|| The font used to render the text in the HUD. 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = HUDFont) 
UFont* hudFont; 
|| New! An array of messages for display 
TArray<Message> messages: 
virtual void DrawHUD() override; 
|| New! A function to be able to add a message to display 
vold addMessage( Message msg }; 
F 
Now, whenever the NPC has a message to display, we're just need to call 
AMyHud: :addMessage() with our message. The message will be added toTArray 
of the messages to be displayed. When a message expires (after a certain amount of 
time), it will be removed from the HUD. 


InsidetheAMy HUD. cpp ple, add the following code: 


void AMyHUD: : Dr awHUD( ) 
{ 
Super: : DrawHUD( ); 
// iterate from back to front thru the list, so if we remove 
|| an item while iterating, there won't be any problems 
for( int c = messages. Num) - 1; c >= 0; c-- ) 
{ 
|| draw the background box the right size 
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|| for the message 
float outputWidth, outputHeight, pad=10.f; 


GetTextSize( messages[c]. message, outputWidth, outputHel ght, 
hudFont, 1.f ); 


float messageH = outputHeight + 2.f*pad; 
float x = 0.f, y = c*messageH: 


|} black backing 

DrawRect( FLinearColor:: Black, x, y, Canvas->SizeX, messageH 
E 

// draw our message using the hudFont 


Drawlext( messages[c]. message, messages[c].color, x + pad, y + 
pad, hudFont ); 


|| reduce lifetime by the time that passed since last 
// frame. 
messages[c].time -= Get World()->GetDeltaSeconds(): 


|| if the message's time is up, remove it 
if( messages[c].time < 0 ) 
{ 
messages. RemoveAt( c ); 
} 
} 
} 


void AMyHUD::addMessage( Message msg ) 
{ 


messages. Add( msg }; 


} 


TheAMy HUD: : Dr awHUD( ) function now draws all the messages in the mess ages 
array, and arranges each message In the messages array by the amount of time 
that passed since the last frame. Expired messages are removed from the messages 
collection once their t i me value drops below 0. 


Exercise 


Refactor the Dr awHUD( ) function so that the code that draws the messages to the 
screen is in a separate function called Dr awMessages(). 


TheCanvas variableis only availablein Dr awHUD( ) , So you will have to save 
Canvas- >SizeX andCanvas- >Si zeY in class-level variables. 
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Refactoring means to change the way code works internally so that it is 
> more organized or easier to read but still has the same apparent result to 
CIS the user running the program. Refactoring often is a good practice. The 
reason why refactoring occurs is because nobody knows exactly what 
the þnal code should look like once they start writing it. 


Solution 
See the AMy HUD: : DrawMessages() function in the code package for this chapter. 


Triggering an event when it is near an NPC 


To trigger an event near the N PC, we need to set an additional collision detection 
volume that is a bit wider than the default capsule shape. The additional collision 
detection volume will be a sphere around each NPC. When the player steps into the 
NPC sphere, the NPC reacts and displays a message. 





ha a I | E-a. 
n O S -A i im = à Se s N | W a 


We're going to add the dark red sphere to the NPC so that he can tell when the player is nearby 
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Inside your NPC. h class ple, add the following code in order to declareProxSphere 
and UFUNCTI ON called Prox: 


UCLASS 


C | 


{ 


}; 


ass GOLDENEGG API ANPC : public ACharacter 


GENERATED UCLASS BODY() 

// This is the NPC's message that he has to tell us. 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
NPCMessage) 

FString NpcMessage; 

|| The sphere that the player can collide with to get item 
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = 
Collision) 

TSubobj ect Ptr<class USphereComponent> ProxSphere: 

|| The corresponding body of this function is 

|| ANPC:: Prox Implementation, _ not __ ANPC::Prox()! 

// This is a bit weird and not what you'd expect, 

// but it happens because this is a BlueprintNativeEvent 
UFUNCTI ON( BlueprintNativeEvent, Category = "Collision") 
void Prox( AActor* OtherActor, UPrimitiveComponent* OtherComp, 
int32 OtherBodylndex, bool bFromSweep, const FHitResult & 
SweepResult ); 


This looks a bit messy, but it is actually not that complicated. Here, we declare an 
extra bounding sphere volume called Pr oxSpher e, which detects when the player is 
near the NPC. 


In theNPC. cpp ple, we need to add the following code in order to complete the 
proximity detection: 


ANPC:: ANPC( const class FPostConstructI nitializeProperties& PCI P) 
Super (PCI P) 


{ 


ProxSphere = PCIP.CreateDefaultSubobj ect <USphereComponent >(this, 
TEXT("Proximty Sphere")); 


ProxSphere->AttachTo( RootComponent ); 

ProxSphere- >SetSphereRadius( 32.f }; 

|| Code to make ANPC::Prox() run when this proximity sphere 
// overlaps another actor. 


ProxSphere->OnComponent BeginOverlap.AddDynamc( this, 
G&ANPC:: Prox ); 


NpcMessage = "Hi, l'm Qwen"://default message, can be edited 
// in blueprints 
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// Note! Although this was declared ANPC::Prox() in the header, 

// it is now ANPC::Prox_Implementation here. 

void ANPC::Prox_Implementation( AActor* OtherActor, 
UPrimitiveComponent* OtherComp, int32 OtherBodylndex, bool 
bFromSweep, const FHitResult & SweepResult ) 


{ 
// This is where our code will go for what happens 
// when there is an intersection 


} 


Make the NPC display something to the HUD when 
something is nearby 


When the player is near the NPC sphere collision volume, display a message to the 
HUD that alerts the player about what the NPC Is saying. 


This ts the complete implementation of ANPC:: Prox Implementation: 


void ANPC:: Prox _Implementation( AActor* OtherActor, 
UPrimitiveComponent* OtherComp, int32 OtherBodyl ndex, bool bFromSweep, 
const FHitResult & SweepResult ) 


{ 
// if the overlapped actor is not the player, 
// you should just simply return fromthe function 
if( Cast<AAvatar>( OtherActor ) == null ptr ) 
{ 
return; 
} 
APlayerController* PController = Get Worl d()- 
>GetFirstPlayerController(); 
if( PController ) 
{ 
AMyHUD * hud = Cast <AMyHUD>( PController->GetHUD() ); 
hud- >addMessage( Message( NpcMessage, 5.f, FColor:: White ) ); 
} 
} 
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The prst thing we do in this function is to cast Ot her Actor (thething that came near 
the NPC) to AAvat ar . The cast succeeds (and isnotnul! ptr) whenotherActor isan 
AAvatar object. We get the HUD object (which happens to be attached to the player 
controller) and pass a message from the NPC to the HUD. The message Is displayed 
whenever the player is within the red bounding sphere surrounding the NPC. 





Owen's greeting 


Exercises 


1. Add auPROPERTY function name for the NPC's name so that the name of the 
NPC is editable in blueprints, similar to the message that the NPC has for the 
player. Show the NPC's name in the output. 


2. Add auPROPERTY function (typeUText ur e2D* ) for the NPC's face texture. 
Draw the NPC's face beside its message in the output. 


3. Render the player's HP as a bar (þlled rectangle). 
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Add this property to theANPC class: 


// This is the NPC's name 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = NPCMessage) 
FString name; 


Then, InANPC: : Prox_| mpl ement at i on, changethe string passed to the HUD to: 
name + FString(": ") + message 

This way, the NPC's name will be attached to the message. 

Addthis property to theANPC class: 


UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = NPCMessage) 
UTexture2D* Face: 


Then you can select face icons to be attached to the NPC's face in blueprints. 
Attach atextureto yourstruct Message: 
UTexture2D* tex; 


To render these icons, you need to add a call toDrawTexture() with theright 
texture passed in to it: 


Drawlexture( messages[c].tex, x, y, messageH, messageH, 0, 0, 1, 1 


E 


Be sure to check whether the texture is valid before you render it. The icons should 
look similar to what is shown here, at the top of the screen: 


Andrew: Ah, how're you doing 


Owen: Hi, I'm Owen 
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This ts how a function to draw the player's remaining health in a bar will look: 


void AMyHUD:: DrawHealthbar() 
{ 
|| Draw the healthbar. 
AAvatar *avatar = Cast <AAvatar >( 
UGamepl ayStatics::GetPlayerPawn(GetWorld(), 0) ); 
float barWidth=200, barHeight=50, barPad=12, barMargin=50; 
float percHp = avatar->Hp / avatar->MaxHp: 


DrawRect( FLinearColor( 0, 0, 0, 1), Canvas->SizexX - barWidth - 
barPad - barMargin, Canvas->SizeY - barHeight - barPad - 
barMargin, barWidth + 2*barPad, barHeight + 2*barPad ); 
DrawRect( FLinearColor( 1-percHp, percHp, 0, 1), Canvas->Sizex 

barWidth - barMargin, Canvas->SizeY - barHeight - barMargin, 
barWidth*percHp, barHeight )}; 


Summary 


In this chapter, we went through a lot of material. We showed you how to create a 
character and display it on the screen, control your character with axis bindings, and 
create and display N PCs that can post messages to the HUD. 


In the upcoming chapters, we will develop our game further by adding an Inventory 
System and Pickup Items in Chapter 10, as well as the code and the concept to account 
for what the player is carrying. Before we do that, though, we will do an in-depth 
exploration of some of the UE4 container types in Chapter 9, Templates and Commonly 
U sed Containers. 
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In Chapter 7, Dynamic M emory Allocation, we spoke about how you will use dynamic 
memory allocation if you want to create a new array whose size isn't known at 
compile time. Dynamic memory allocations are of theformint * array = new 
int{ number of elements |. 


You also saw that dynamic allocations using thenew[ ] keyword require you to call 
del ete[] onthearray later, otherwise you'd havea memory leak. Having to manage 
memory this way is hard work. 


Is there a way to create an array of dynamic size and have the memory automatically 
managed for you by C++? The answer is yes. There are C+ object types (commonly 
called containers) that handle dynamic memory allocations and deallocations 
automatically. UE4 provides a couple of container types to store your data in 
dynamically resizable collections. 


There are two different groups of template containers. There is the UE4 family of 
containers (beginning with T* ) and the C++ Standard Template Library (STL) family 
of containers. There are some differences between the U E4 containers and the C++ STL 
containers, but the differences are not major. UE4 containers sets are written with game 
performance in mind. C++STL containers also perform well, and their interfaces are 

a little more consistent (consistency in an API is something that you'd prefer). Which 
container set you use is up to you. However, it is recommended that you use the UE4 
container set since it guarantees that you won't have cross-platform issues when you 
try to compile your code. 
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Debugging the output in UE4 


All of the code in this chapter (as well as in the later chapters) will require you to 
work in aUE4 project. For the purpose of testing TAr r ay, 1 created abasic code 
project called TArrays.IntheATArraysGameMode:: ATArraysGameMode constructor, 
| am using the debug output feature to print text to the console. 


Here's how the code will look: 


ATArraysGameMode::ATArraysGameMode(const class 
FPostConstructI nitializeProperties& PCIP) : Super(PCl P) 
{ 
if( GEngine ) 
{ 
GEngi ne- >AddOnScreenDebugMessage( 0, 30.f, FColor:: Red, 
"Hello!" j; 
} 
} 


If you compile and run this project, you will see the debug text in the top-left corner 
of your game window when you start the game. You can use a debug output to see 
the internals of your program at any time. J ust make sure that theGEngi ne object 
exists at the time of debugging the output. The output of the preceding code is 
shown in the following screenshot: 


Hello! 





UE4's TArray<T> 


TArrays are UE4's version of a dynamic array. To understand what aTArray<T> 
variable is, you prst have to know what the <T > option between angle brackets 
stands for. The<T > option means that the type of data stored in the array isa 
variable. Do you want an array of i nt ? Then createaTArray<i nt > variable. 
ATArray variable of doubl e? CreateaTArray<doubl e> variable. 


So, in general, wherever a <T > appears, you can plug in a C-type of your choice. 
Let's move on and show this with an example. 
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An example that uses TArray<T> 


ATArray<int > variableis just an array ofi nt. ATArray<Pl ayer*> variable will be 
an array of P| ayer * pointers. An array is dynamically resizable, and elements can be 
added at the end of the array after its creation. 


To createaTArray<i nt > variable, all you have to do is use the normal variable 
allocation syntax: 


TArray<int> array; 


Changes to theTArray variable are done using member functions. There area 
couple of member functions that you can useon aTArray variable. The prst member 
function that you need to Know about is the way you add a value to the array, as 
shown in the following code: 


array. Add( 1 ); 
array. Add( 10 ); 
array. Add( 5 ); 
array. Add( 20 ); 


These four lines of code will produce the array value in memory, as shown in the 
following bgure: 





array 


When you callarray.Add( number ) , the new number goes to the end of the array. 
Since we added the numbers 1, 10, 5, and 20 to the array, in this order, that is the 
order in which they will go into the array. 


If you want to Insert a number in the front or middle of the array, it is also possible. 
All you haveto doisusethearray.|Insert(value, index) function, as shown in 
the following line of code: 


array.insert( 9, 0 ); 
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This function will push the number 9 into the position 0 of the array (at the front). 
This means that the rest of the array elements will be offset to the right, as shown in 
the following bgure: 





array 


We can insert another element into position 2 of the array using the following line 
of code: 


array.Insert( 30, 2 ); 


This function will rearrange the array as shown in the following bgure: 


1 30 10 5 20 


array 





i . . PII . 
Q If you insert anumber into a position in the array that is out of bounds, 


UE4 will crash. So be careful not to do that. 


iterating a TArray 


You can iterate (walk over) the dements of aTArr ay variablein two ways: either using 
integer-based indexing or using an iterator. | will show you both the ways here. 


The vanilla for loop and square brackets notation 


Using integers to index the elements of an array is sometimes called a "vanilla" f or 
loop. The elements of the array can be accessed usingarray[ index ],wherei ndex 
is the numerical position of the dement in the array: 


for( int index = 0; Index < array. Num(); index++ ) 


{ 


// print the array element to the screen using debug message 
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GEngi ne- >AddOnScreenDebugMessage( index, 30.f, FColor:: Red, 
FString::Fromlnt( array[ index ] ) ); 


} 


iterators 


You can also use an iterator to walk over the elements of the array one by one, as 
shown in the following code: 


int count = 0: || keep track of numerical index in array 
for( TArray<int>::Tlterator it = array. Createlterator(); it; ++it 


{ 
GEngine->AddOnScreenDebugMessage( countt++, 30.f, FColor:: Red, 
FStringiiFrom nt it ) ): 

} 


Iterators are pointers into the array. Iterators can be used to inspect or change values 
inside the array. An example of an iterator is shown in the following þgure: 


1 30 10 5 20 





The concept of an iterator: it is an external object that can look into and inspect the 
values of an array. Doing ++ it moves the iterator to examine the next element. 


An iterator must be suitable for the collection it is walking through. To walk through 
aTArray<int > variable, you need aTArray<int>::Tlterator type iterator. 


We use* to look at the value behind an iterator. In the preceding code, we used 
(*it) toge the integer value from the iterator. This is called dereferencing. To 
dereference an iterator means to look at its value. 


The++i t operation that happens at the end of each iteration of thef or loop 
increments the iterator, moving it on to point to the next element in the list. 
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Insert the code into the program and try it out now. Here's the example program we 
have created so far usingTArray (all intheATArraysGameMode:: ATArraysGameMo 
de() constructor): 


ATArraysGameMode::ATArraysGameMode(const class 
FPostConstructInitializeProperties& PCIP) : Super( PCI P) 
{ 
TArray<int> array: 
array. Add( 1 ); 
array. Add( 10 ); 
array. Add( 5 ); 
array. Add( 20 ); 
array.insert( 9, 0 );// put a 9 in the front 
array. nsert( 30, 2 );// put a 30 at index 2 
if( GEngine ) 
{ 
for( int index = 0; Index < array. Num(); index++ ) 
{ 


GEngi ne- >AddOnScreenDebugMessage( index, 30.f, FColor:: Red, 
FString::Fromint( array[ index ] ) ); 


i 
} 
} 


The output of the preceding code is shown in the following screenshot: 





Finding whether an element is in the TArray 


Searching out U E4 containers is easy. It is commonly done using theFi nd member 
function. Using the array we created previously, we can pnd the index of the value 
10 by typing the following line of code: 


int index = array. Find( 10 ); // would be index 3 in image above 


— izn 
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TSet<T> 


A TSet <i nt > variable stores a set of integers. A TSet <F String> variable. stores a set 
of strings. The main difference betweenTSet andTArray isthatTSet does not allow 
duplicates—all the elements inside aTSet are guaranteed to be unique. A TArray 
variable does not mind duplicates of the same elements. 


To add numbers toTSet , simply call Add. Take an example of the following 
declaration: 


TSet<int> set: 


set. Add( 1 }; 
set. Add( 2 }; 
set. Add( 3 }; 
set. Add( 1 );// duplicate! won't be added 
set. Add( 1 );// duplicate! won't be added 


This is how TSet will look, as shown in the following bgure: 





set 


Duplicate entries of the same valuein theTSet will not be allowed. Notice how the 
entries in aTSet aren't numbered, as they werein aTArray: you can't use square 
brackets to access an entry inTSet arrays. 


iterating a TSet 


In order to look into aTSet array, you must use an iterator. You can't use square 
brackets notation to access the elements of aTSet : 


int count = p; || keep track of numerical index in set 
for( TSet<int>::Tlterator it = set.Createlterator(); it; ++it ) 


{ 
GEngi ne- >AddOnScreenDebugMessage( count++, 30.f, FColor:: Red, 
FString::Fromint( *it ) J; 


} 
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Intersecting TSet 


TheTSet array has two special functions that the TAr ray variable does not. The 
intersection of twoTSet arrays is basically the elements they havein common. If 
wehavetwoTSet arrays such asX and Y and we intersect them, the result will bea 
third, new TSet array that contains only the elements common between them. Look 
at the following example: 


TSet<int> X; 
X. Add( 1 ); 
X. Add( 2 ); 
X,Add( 3 ); 
TSet<int> Y; 
Y. Add( 2 ); 
Y. Add( 4 ); 
Y. Add( 8 ); 


TSet<int> common = X.Intersect(Y): // 2 


The common elements between X and Y will then just be the element 2. 


Unioning TSet 
Mathematically, the union of two sets is when you basically insert all the elements 
into the same set. Since we are talking about sets here, there won't be any duplicates. 


If wetaketheX andy sets from the previous example and create a union, we will get 
anew set, as follows: 


TSet<int> uni = X.Union(Y); {7 1, 2, 3, 4, 8 


Finding TSet 


You can determine whether an element is insideaTSet or not by using theFi nd() 
member function on the set. TheTSet will return a pointer to the entry in theTSet 
that matches your query if the element exists in theTSet , or it will return NULL if the 
element you're asking for does not exist in theTSet . 


VOcr >V.'U@ 


ATMap<T, S> creates atable of sorts inthe RAM. A TMap represents a mapping of 
the keys at the left to the values on the right-hand side. You can visualizeaTMap asa 
two-column table, with keys tn the left column and values in the right column. 
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A list of items for the player's inventory 


For example, say we wanted to create a C++ data structure in order to store a list of 
items for the player's inventory. On the left-hand side of the table (the keys), we'd 
haveanF String for the item's name. On the right-hand side (the values), we'd have 
ani nt for the quantity of that item. 


Item (K ey) Quantity (Value) 





To do this in code, we'd simply use the following: 


TMap<FString, int> items; 
items.Add( "apples", 4 ); 
items. Add( "donuts", 12 ); 
items. Add( "swords", 1 ); 
items. Add( "shields", 2 ); 


Once you have created your T Map, you can access values inside theT Map using 
square brackets and by passing a key between the brackets. For example, in the 


items map inthe preceding code,items[ "apples" ] Is4. 
my UE4 will crash if you use square brackets to access a key that doesn't 
exist in the map yet, so be careful! The C++STL does not crash if you 
do this. 


iterating a TMap 


In order to iterate aT Map, you usean iterator as well: 


for( TMap<FString, int>::Tlterator it = 1tems.Createlterator(); it; 
+tit ) 
{ 
GEngi ne- >AddOnScreenDebugMessage( countt++, 30.f, FColor:: Red, 
it->Key + FString(": ") + FString::Fromnt( 1t->Value ) ); 
} 
$4359] AMA 
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TMap iterators are slightly different fromTArray orTSet iterators. A TMap iterator 
contains both aKey and aVal ue. We can access the key inside withi t- >Key and the 
value inside theT Map withit->Value. 


apples 


donuts 


swords 


Taek 





C++ STL versions of commonly used 
containers 


| want to cover the C++ STL versions of a couple of containers. STL is the standard 
template library, which is shipped with most C++ compilers. The reason why | want 
to cover these STL versions is that they behave somewhat differently than the UE4 
versions of the same containers. In some ways, their behavior is very good, but game 
programmers often complain of STL having performance issues. In particular, | want 
to cover STL'sset and map containers. 


If you like STL's interface but want better performance, there isa 
_ well-known reimplementation of the STL library by Electronic Arts 
% called EASTL, which you can use. It provides the same functionality 
J +~— aS STL but is implemented with better performance (basically by 
doing things such as eliminating bounds checking). It is available on 
GitHubathttps://github. com/ paul hodge/ EASTL. 
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C++ STL set 


A C++set is a bunch of items that are unique and sorted. The good feature about 
the STL set is that it keeps the set elements sorted. A quick and dirty way to sorta 
bunch of values is actually to just shove them Into the sames et . Theset will take 
care of the sorting for you. 


Wecan return to asimple C++ console application for the usage of sets. To use the 
C++STL set you need to include <s et >, as shown here: 


#include <iostream> 
#include <set> 
using namespace std; 


int main() 
{ 
set <int> | ntSet; 
intSet.insert( 7 ); 
intSet.insert( 7 ); 
intSet.insert( 8 ); 
intSet.insert( 1 ); 
for( set<int>::iterator it = intSet.begin(); it != intSet.end(); 
++it ) 
{ 
cout << *it << endl; 
} 
} 


The following is the output of the preceding code: 


1 
] 
8 


The duplicate7 is þltered out, and the elements are kept in increasing order inside 
thes et . The way we iterate over the elements of an STL container is similar to UE4's 
TSet array. Thei nt Set. begin() function returns an iterator that points to the head 
of thei nt Set. 
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The condition to stop iterating is when i t becomesintSet.end().intSet.end() Is 
actually one position past the end of thes et , as shown in the following bgure: 


intSet 


intSet.begin() intSet.end() 





Finding an element in a <set> 

To pnd an element inside an STL set , we can use thef i nd() member function. 

If the item we're looking for turns up in thes et , we get an iterator that points to 
the element we were searching for. If the item that we were looking for is not in the 
set, wege backs et. end() instead, as shown here: 


Set<int>::iterator it = intSet.find( 7 ); 
if( it != intSet.end() ) 
{ 


// 7 was inside intSet, and *it has its value 
cout << "Found " << *it << endl: 


} 


Exercise 

Ask the user for a set of three unique names. Take each name in, one by one, 
and then print them in a sorted order. If the user repeats a name, then ask them 
for another one until you get to three. 


Solution 


The solution of the preceding exercise can be found using the following code: 


#include <iostream> 
#include <string> 
#include <set> 

using namespace std: 
int main() 


{ 
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Set<string> names: 
|| so long as we don't have 3 names yet, keep looping, 
while( names.size() < 3 ) 


{ 
cout << names.size() << " names so far. Enter a name" << endl: 
string name: 
cin >> name; 
names. insert( name ); // won't insert if already there, 
} 
// now print the names. the set will have kept order 


for( set<string>::iterator it = names. begin(); it != 
names. end(); ++it ) 
{ 
cout << *it << endl; 
} 
} 


C++ STL map 


TheC++STL map object is alot like UE4'sTMap object. The one thing it does that 

TMap does not is to maintain a sorted order inside the map as well. Sorting introduces 
an additional cost, but if you want your map to be sorted, opting for the STL version 
might be a good choice. 


To usethe C++STL map object, weinclude<map >. In the following example program, 
we populate a map of items with some key-value pairs: 


#include <iostream> 

#include <string> 

#include <map> 

using namespace std: 

int main() 

{ 
map<string, int> items; 
items.insert( make pair( "apple", 12 ) ) 
items.insert( make pair( "orange", 1 ) ) 
items.insert( make pair( "banana", 3 ) ) 
// can also use square brackets to inser 
items[ "kiwis" ] = 44; 


t into an STL map 


for( map<string, int>::iterator it = items. begin(); it != 
items.end(); ++it ) 
{ 
cout << “items[ " << it->first <<" ] =" << it->second << 
endl ; 
} 
} 
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This ts the output of the preceding program: 


items[ apple ] = 12 
items[ banana ] = 3 
items, kiwis ] = 44 
items[ orange ] = 1 


N otice how the iterator's syntax for an STL map is slightly different than that of 
TMap: we access the key usingit->first and thevalueusingi t->second. 


Notice how C++STL also offers a bit of syntactic sugar over T Map ; you can use 
square brackets to insert into the C+ STL map. You cannot use square brackets 
to insert into aTMap. 


Finding an element in a <map> 


You can search a map fora <ey,val ue >pair using the STL map'sf i nd 
member function. 


Exercise 


Ask the user to enter bve items and their quantities into an empty map. Print the 
results in sorted order. 


Solution 


The solution of the preceding exercise uses the following code: 


#include <iostream> 
#include <string> 
#include <map> 
using namespace std; 
int main() 
{ 
map<string, int> items; 
cout << "Enter 5 items, and their quantities" << endl; 
while( items.size() <5 } 
{ 
cout << "Enter item" << endl; 
string item; 
cin >> item: 
cout << "Enter quantity" << endl: 


int qty; 
cin >> qty; 
items[ item] = qty; // Save in map, square brackets 
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// notation 


} 


for( map<string, int>::iterator it = items. begin(); it != 
items.end(}); ++it ) 
{ 
cout << "items[ " << it->first <<" ] =" << it->second << 
endl ; 
} 


} 


In this solution code, we start by creating map<string, int> items tostoreall the 
items we're going to take in. Ask the user for an item and a quantity; then we save 
thei teminthei t ems map using square brackets notation. 


Summary 


UE4's containers and the C++ STL family of containers are both excellent for storing 
game data. Often, a programming problem can be simpliped many times by selecting 
the right type of data container. 


In the next chapter, we will actually get to programming the beginning of our game 
by keeping track of what the player is carrying and storing that information ina 
TMap object. 
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Inventory System 
and Pickup Items 


We want our player to be able to pick up items from the game world. In this chapter, 
we will code and design a backpack for our player to store items. We will display 
what the player is carrying in the pack when the user presses the! key. 


As a data representation, we can usetheTMap<F String, int > Items covered in the 
previous chapter to store our items. When the player picks up an item, we add It to 
the map. If the item is already in the map, we just increase its value by the quantity 
of the new items picked up. 


Declaring the backpack 


We can represent the player's backpack asasimpleTMap<FString, int> item. 
To allow your player to gather items from the world, open theAvatar.h þle and 
add the following TMap declaration: 


// forward declare the APickupltem class, 
// since it will be "mentioned" in a member 
function decl below 


class APickupltem; 


UCLASS() 
class GOLDENEGG API AAvatar : public ACharacter 


{ 
GENERATED UCLASS BODY() 


// A map for the player's backpack 
TMap<FString, int> Backpack; 


// The icons for the items in the backpack, lookup by string 
TMap<FString, UTexture2D*> Icons; 
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// A flag alerting us the Ul is showing 

bool inventoryShowi ng; 

|| member function for letting the avatar have an item 
void Pickup( APickupltem *item ); 

II ... rest of Avatar.h same as before 


Forward declaration 


BeforeAAvat ar class, noticethat wehaveac! ass APickupl tem forward 
declaration. Forward declarations are needed in a code ble when a class is mentioned 
(such astheAPi ckupltem::Pickup( APickupltem *i tem ); function prototype), 
but there is no code in the ble actually using an object of that type inside the ple 
Since the Avatar. h header ble does not contain executable code that uses an object 
of the typeAPi ckup! t em, a forward declaration is what we need. 


The absence of a forward declaration will give a compiler error, since the 
compiler won't have heard of cl ass APickupl tem before compiling the code 
Incl ass AAvatar.Thecompiler error will come at the declaration of the 
APickupltem:: Pickup( APickupltem *item ); function prototype declaration. 


We declared twoTMap objects inside theAAvat ar class. This is how the objects will 
look, as shown in the following table: 


FString (name) i nt (quantity) UTexture2D* (im) 


— 


In theTMap backpack, we storetheF String variable of the item that the player is 
holding. In the! cons map, we store a single reference to the image of the item the 


player is holding. 
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At render time, we can use the two maps working together to look up both the 
quantity of an item that the player has (in his Backpack mapping) and the texture 
asset reference of that item (in the! cons map). The following screenshot shows how 
the rendering of the HUD will look: 





N ote that we can also use an array of struct withanFString variable 
and UText ur e2D* in itinstead of using two maps. 
For example, we can keep TArray<ltem> Backpack; withastruct 
variable, as shown in the following code: 

Struct Item 

{ 


FString name; 


int qty; 
nat UTexture2D* tex: 


i 
Then, as we pick up items, they will be added to the linear array. 
H owever, counting the number of each item we have in the backpack will 
require constant reevaluation by iterating through the array of items each 
time we want to se the count. For example, to see how many hairbrushes 
you have, you will need to make a pass through the whole array. This is 
not as efþcient as using a map. 


Importing assets 


You might have noticed the Cow asset in the preceding screenshot, which is not 

a part of the standard set of assets that U E4 provides in a new project. In order to 
use the Cow asset, you need to import the cow from the Content Examples project. 
Thereis a standard importing procedure that U E4 uses. 
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In the following screenshot, | have outlined the procedure for importing the Cow 
asset. Other assets will be imported from other projects in UE4 using the same 
method. Perform the following steps to import the Cow asset: 


1. Download and open UE4's Content Examples project: 


Search For Help 


wills v 
a bill. sherif@gmail.com Engine Feature Samples 


~ame Features Tour 2014 


Epic's GDC2014 Demo! This 
project walks you through 
Unreal Engine features like 
the new material system 


and Blueprints 


Content Examples 


This museum-style project 
has a collection of maps 
with stands that 

demol te specific 


concepts or techniques! 


Particle Effects 


This project shows off a 
variety of particle systems 
that demonstrate various 
environmental and 


elemental effects 





2. After you have downloaded Content Examples, open it and click on 
Create Project: 


Choose Project Name and Location 
Name:| ContentExamples 
Folder[Y/Unreal Projects/Contentexamples E 





Y:/Unreal Projects/ContentExamples/ContentExamples.uproject 


EKZ acs 
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3. Next, name the folder in which you will put your Cont ent Examples and 
click on Create. 


4. Open your Content Examples project from the library. Browse the assets 
available in the project until you pnd one that you like. Searching for 
SM_ will help since all static meshes usually begin with SM_ by convention. 


= Content Browser, 


new- Piimport mT e 


earch Folders p AICEA SM_ 


F : + s 
@ Animations g- “3 
> fi Assets 


Bu Blueprints 
@ Character e2 ElatWall 
> EE DemoRoom 


Bu Effects 
> EE Environment 
> fi ExampleContent 


l? 
[ 
A Maps 
> EE Textures Battery 


Trims iat Medium 


Button 


Smi ai 


aooescosn 


mri 
eis Divider. 2 


T ECLELLE 


10 10 std 
miitrim Pe Trim RoomtTrin J. RoomU Ri OmU? Ri om 





Lists of static meshes, all beginning with SM _ 
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5. When you pnd an asset that you like, import it into your project by 
right-clicking on the asset and then clicking on M igrate...: 


Replace References 
Export... 
|_Demoa 


Cube Nay 22 -Vemo SME | Show In Explorer 
Obstacle 


Create Blueprint Using... 


: ; Copy Reference ; 
Demo | Dema PY Bema 
Room Rom rim- Reon Reference Viewer... oml 


n E Open StaticMesh.h 
TENLALID 


Destro nie: Dee Pi view Documentation 
_DM i 


l- 
Pa 
Ce tes source Control 


piperi Dome SoM aes Deo. heorrame 


Destruc TIBE 





6. Click on OK in the Asset Report dialog: 


AL Asset Repor 


The following assets will be migrated to another content folder. 


Pi Game 
a fig ExampleContent 


a fi Blueprints 
a B Materials 
A M_Orange_Shiny 
4 fie Meshes 
SM_Door 
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7. Select the Content folder from your project that you want to add the SM _ 
Door bleto. For me, I wantto add ittoY:/ Unreal Proj ects/ Gol denEgg/ 
Cont ent , as shown in the following screenshot: 


Browse For Folder 


Choose a destination Content Folder 


= di Unreal Projects 
+ m Basecade 
+ m BasicCade 
+ di CantentEx amples 
= di Goldenegg 


di Binaries 


|) Build 
m Config 
BOY content 


di Intermediate 
di Saved 
di Source 


Folder; [Content 
Make New Folder | Cancel | 
A 








8. Ifthe import was completed successfully, you will see a message as follows: 


_ Content migration completed nhe 





9. Once you import your asset, you will see it show up in your asset browser 
inside your project: 


= Content Browser @@ Class Viewer 
New- limport 
ab | = Game >» 


Search Folders : Jees SMDoor j= =ë X SMDor = X 


e gs Engine 
> fi AnimStarterPack 


i Blueprints 

ii Character Mo Dù SI ! 
> i DemoRoom Frame 
b fi ExampleContent 





You can then use the asset inside your project normally. 
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Attaching an action mapping to a key 

We need to attach a key to activate the display of the player's inventory. Inside 
the UE4 editor, add an Action Mappings + called! nvent ory and assign it to the 
keyboard key |: 


Project Engine - Input 


hs These settings are saved in Defaultinput.ini, which is currently 


4 Bindings 
4 Action Mappings + Qj 
FE inventory + x 
4 Axis Mappings + 


rE Forward 


PE Strafe 





IntheAvatar. h ble add a member function to be run when the player's inventory 
needs to be displayed: 


void Togglelnventory(); 


IntheAvatar.cpp þle,implementtheTogglelnventory() function, as shown in the 
following code: 


void AAvatar::Togglelnventory() 


{ 
if( GEngine ) 
{ 
GEngi ne- >AddOnScreenDebugMessage( 0, 5.f, FColor:: Red, 
"Showing inventory..." ); 
} 
} 


Then, connect the" | nventory" actiontoAAvatar::Togglelnventory() in 
SetupPlayerl nputComponent(): 
void AAvatar::SetupPlayerlnput Component(class Ulnput Component * 
Input Component) 


{ 


InputComponent->BindAction( "Inventory", IE Pressed, this, 
&AAvatar::Togglelnventory ); 
|| rest of SetupPlayerlnputComponent same as before 


} 
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Dcug ercuu'Rlenw Kgo 


We need to debne how a pickup item looks in code. Each pickup item will derive 
from a common base class. Let's construct the base class for aPi ckup! t em class now. 


ThePi ckupl t em base class should inherit from the AAct or class. Similar to how we 
created multiple NPC blueprints from the base NPC class, we can create multiple 

Pi ckupl tem blueprints from asinglePi ckupl t em base class, as shown in the 
following screenshot: 


Choose Parent Class Name Your New Actor 


Enter a name for your new class. Class names may only contain alphanumeric 
When you click the “Create” button below, a header (h) file and a source (.cpp 


Path Y:/Unreal Projects/GoldenEgq/Source/GoldenEgg/ 


You are about to add a C++ source code file. To compile these files you must have Visual 





Once you have created the Pi ck up! t em class, open its code in Visual Studio. 
TheAPi ckupl t em class will need quite a few members, as follows: 


e AnFString variable for the name of the item being picked up 
e Ani nt32 variablefor the quantity of the item being picked up 


e A USphereComponent variable for the sphere that you will collide with for 
the item to be picked up 


e AUStaticMeshComponent variable to hold the actual Mesh 
e A UTexture2D variable for the icon that represents the item 
e A pointer for the HUD (which we will initialize later) 


This is how the codein Pi ckupl tem. h looks: 


UCLASS() 
class GOLDENEGG API APickupltem: public AActor 


{ 
GENERATED UCLASS BODY() 
|| The name of the item you are getting 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Item) 
FString Name; 


// How much you are getting 
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UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Item) 
int32 Quantity; 


|| the sphere you collide with to pick item up 
UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category = 
| t em) 

TSubobj ect Ptr<USphereComponent > ProxSphere; 


|| The mesh of the item 

UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category 
| t em) 

TSubobj ect Ptr<UStaticMeshComponent> Mesh; 


// The icon that represents the object in UIl/canvas 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Item) 
UTexture2D* Icon; 


|| When something comes inside ProxSphere, this function runs 
UFUNCTION( BlueprintNativeEvent, Category = Collision) 

void Prox({ AActor* OtherActor, UPrimitiveComponent* OtherComp, 
int32 OtherBodyl ndex, bool bFromSweep, const FHitResult & 
SweepResult ); 


}; 


The point of all theseUPROPERTY() declarations is to makeAPi ckup! t em completely 
conpgurable by blueprints. For example, the items in the Pickup category will be 
displayed as follows in the blueprints editor: 


4 Pickup 


Name 


Quantity 
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InthePi ckupl tem. cpp ple, we complete the constructor for the APi ckup! t em class, 
as shown in the following code: 


APickupltem::APickupltem( const class 
FPostConstructI nitializeProperties& PCIP) : Super( PC! P) 


{ 
Name = "UNKNOWN ITEM"; 
Quantity = 0; 


// initialize the unreal objects 

ProxSphere = PCIP.CreateDefaultSubobj ect <USphereComponent >(this, 
TEXT("ProxSphere")): 

Mesh = PCIP.CreateDefaultSubobj ect <UStati cMeshComponent >(this, 
TEXT("Mesh")); 


|| make the root object the Mesh 
RootComponent = Mesh; 
Mesh- >SetSi mul atePhysics(true); 


|| Code to make APickupltem::Prox() run when this 

|| object's proximity sphere overlaps another actor. 
ProxSphere->OnComponent BeginOverlap.AddDynamic(this, 
GAPi ckupltem:: Prox); 

ProxSphere->AttachTo( Mesh ); // very important! 


} 


In the prst two lines, we perform an initialization of Name and Quantity to values 
that should stand out to the game designer as being uninitialized. | used block 
capitals so that the designer can clearly see that the variable has never been 
initialized before. 


We then initializetheProxSphere and Mesh components using PC! P. 
CreateDefaultSubobj ect . Thefreshly initialized objects might have some of their 
default values initialized, but Mesh will start out empty. You will have to load the 
actual mesh later, inside blueprints. 


For the mesh, we Set it to simulate realistic physics so that pickup items will bounce 
and roll around if they are dropped or moved. Pay special attention to the line 
ProxSphere->AttachTo( Mesh ).Thislinetells you to make sure the pickup item's 
ProxSphere component is attached to theMes h root component. This means that when 
the mesh moves in the level, Pr oxSphere follows. If you forget this step (or if you did 
it the other way around), then Pr oxSphere will not follow the mesh when it bounces. 
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The root component 


In the preceding code, weassigned Root Component OF APi ckupl temtotheMesh object. 
TheRoot Component member is a part of theAAct or base class, so every AAct or and Its 
derivatives has a root component. The root component is basically meant to be the core 
of the object, and also depnes how you collide with the object. TheRoot Component 
object is debned in theAct or. h ple, as shown in the following code: 
I x x 
* Collision primitive that defines the transform (location, 
rotation, scale) of this Actor. 
ef 
UPROPERTY( ) 
class USceneComponent* RootComponent; 


So the UE4 creators intended Root Component to always bea reference to the collision 
primitive. Sometimes the collision primitive can be capsule shaped, other times it 

can be spherical or even box shaped, or it can be arbitrarily shaped, as in our case, 
with the mesh. It's rare that a character should have a box-shaped root component, 
however, because the corners of the box can get caught on walls. Round shapes are 
usually preferred. TheRoot Component property shows up in the blueprints, where 
you can see and manipulate it. 


MEP Pioniplooldenead 
e Edit Asset View Debug Window Help Pickup Item.h & 
= F i > 
kz i io) Fe | i> EV) Defaults ) = aa 
Compile Saye FindinCB Blueprint Props Simulation ams 


A Components 


@ Add Component ~ 
e Class Asset 
4 [ROOT] Mesh Shape_Sphere 


Mesh Shape_Sphere 


4 Shape 


Sphere Radius 


4 Physics 


Simulate Physics 


Locked Axis 


4 Collision 





Simulation Generates Hi E 


You can edit the ProxSphere root component from its blueprints once you create a blueprint based on the 
Pickupltem class 
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Finally, theProx_| mp! ement at i on function gets implemented, as follows: 


void APickupltem::Prox_Implementation( AActor* OtherActor, 


} 


UPrimitiveComponent* OtherComp, int32 OtherBodylndex, bool 
bFromSweep, const FHitResult & SweepResult ) 


// if the overlapped actor is NOT the player, 
|} you simply should return 
if( Cast<AAvatar>( OtherActor ) == nullptr ) 


return: 


} 


|| Get a reference to the player avatar, to give him 
// the item 

AAvatar *avatar = Cast <AAvatar >| 

UGamepl ayStatics::GetPlayerPawn( GetWorld(), 0 ) ); 


/ Let the player pick up item 

| Notice use of keyword this! 

| That is how this. Pickup can refer to itself. 
vatar->Pickup( this ); 


// Get a reference to the controller 
APlayerController* PController = Get Worl d()- 
>GetFirstPlayerController(); 


|| Get a reference to the HUD fromthe controller 
AMyHUD* hud = Cast <AMyHUD>( PController->GetHUD() ); 
hud- >addMessage( Message( Icon, FString("Picked up ") + 
FString::Fromlnt( Quantity) + FString(" ") + Name, 

5.f, FColor:: White, FColor::Black ) ); 


Destroy(); 


A couple of tips here that are pretty important: prst, we have to access a 


couple of globals to get the objects we need. There are three main objects we'll 


be accessing through these functions that manipulate the H UD: the controller 


(APl ayerController), the HUD (AMy HUD), and the player himself (AAvat ar ). 
There is only one of each of these three types of objects in the game instance. 


UE4 has made pnding them easy. 
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Getting the avatar 
Thepl ayer class object can be found at any time from any place in the code by 
simply calling the following code: 

AAvatar *avatar = Cast <AAvatar >( 


UGamepl ayStatics::GetPlayerPawn( GetWorld(), 0 ) ); 
Wethen pass him the item by calling theAAvat ar: : Pi ckup() function depned earlier. 


Because theP! ayer Pawn objectis really anAAvat ar instance, we cast the result to the 
AAvatar class, using theCast <AAvat ar > command. TheUGamep! ayStatics family 
of functions are accessible anywhere in your code—they are global functions. 


Getting the player controller 


Retrieving the player controller is from a superglobal as well: 


APlayerController* PController = 
Get Worl d()->GetFirstPlayerController(); 


TheGet Wor! d() function is actually debned in theU0bj ect base class. Since all 
UE4 objects derive from U0bj ect , any object in the game actually has access to the 
worl d Object. 


Getting the HUD 


Although this organization might seem strange at þrst, the HUD is actually attached 
to the player's controller. You can retrieve the HUD as follows: 


AMyHUD* hud = Cast <AMyHUD>( PController->GetHUD() ); 


We cast the HUD object since we previously set the HUD to being an AMy HUD 
Instance in blueprints. Since we will be using the HUD often, we can actually store 
a permanent pointer to the HUD inside our APi ckup! t em class. We will discuss this 
point later. 


Next, weimplement AAvatar: : Pickup, which adds an object of the type 
APi ckup! t em to Avatar's backpack: 


void AAvatar::Pickup( APickupltem *item ) 


{ 
if( Backpack. Find( item->Name ) ) 


{ 
|| the item was already in the pack.. Increase qty of it 
Backpack| item->Name |] += item->Quantity; 
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|| the item wasn't in the pack before, add it in now 
Backpack. Add(item->Name, item->Quantity); 
|| record ref to the tex the first time it is picked up 
Icons. Add(item->Name, item->Il con); 
} 
} 


In the preceding code, we check whether the pickup item that the player just got is 
already in his pack. If itis, we increase its quantity. If it is not in his pack, we add it 
to both his pack and the! cons mapping. 


To add the pickup items to the pack, use the following line of code: 
avatar->Pickup( this ); 


TheAPickupl tem: : Prox_| mpl ement ati on isthe way this member function will 
get called. 


Now, weneed to display the contents of our backpack in the HUD when the 
player presses |. 


Drawing the player inventory 


An inventory screen in a game such as D iablo features a pop-up window, with the 
icons of the items you've picked up in the past arranged in a grid. We can achieve 
this type of behavior in UE4. 


There are a number of approaches to drawing a UI in UE4. The most basic way is 

to simply usetheHUD: : DrawTexture() calls. Another way is to use Slate. Another 
way still is to use the newest UE4 UI functionality: Unreal M otion Graphics (UMG) 
Designer. 


Slate uses a declarative syntax to lay out UI elements in C+ Slate is best suited 
for menus and the like UMG is new in UE 4.5 and uses a heavily blueprint-based 
workyow. Since our focus here is on exercises that use C++ code, we will stick toa 
HUD: : DrawText ure() implementation. This means that we will have to manage all 
the data that deals with the inventory in our code. 
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Using HUD::DrawTexture() 


We will achieve this in two steps. The prst step is to push the contents of our inventory 
to the HUD when the user presses the! key. The second step is to actually render the 
icons into the HUD in agrid-like fashion. 


To keep all the information about how a widget can be rendered, we declare a simple 
structure to keep the information concerning what icon it uses, its current position, 
and current size. 


This is how thel con and Wi dget structures look: 


Struct Icon 
{ 
FString name; 
UTexture2D* tex; 
lcon(){ name = "UNKNOWN ICON"; tex = 0; } 
lcon( FString& i Name, UTexture2D* iTex ) 
{ 
name = | Name; 
tex = iTex; 
} 
k 


struct Widget 
{ 

Icon icon; 

FVector2D pos, size; 

Wi dget(Icon iicon) 

{ 

icon = iicon; 

} 

float left(){ return pos. X; } 

float right(){ return pos.X + size.X; } 

float top(){ return pos. Y; } 

float bottom ){ return pos.Y + size. Y; } 
i. 


You can add these structure declarations to the top of My HUD. h, or you can add them 
to a separate ble and include that ble everywhere those structures are used. 


N otice the four member functions on theWi dget structureto get tothe! eft(), 
right(),top(),andbottom() functions of the widget. We will use these later to 
determine whether a click point is inside the box. 
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Next, we declare the function that will render the widgets out on the screen in the 
AMy HUD class: 


void AMyHUD:: DrawWi dgets() 


{ 


} 


for( int c = 0; c < widgets. Num); c++ ) 

{ 
Drawlexture( widgets[c].icon.tex, widgets[c].pos.X, 
widgets[c].pos.Y, widgets[c].size.X, widgets[c].size.Y, 0, 0, 
Le a ie 
Drawlext( widgets[c].icon.name, FLinearColor:: Yellow, 
widgets[c].pos.X, widgets[c].pos.Y, hudFont, .6f, false ); 

} 


A call to the Dr awWi dgets() function should be added to the Dr awHUD( ) function: 
void AMyHUD: : Dr awHUD( ) 


{ 


} 


Super: : DrawHUD( ); 

// dims only exist here in stock variable Canvas 
// Update them so use in addWi dget() 

dims.X = Canvas- >Sizex; 

dims. Y = Canvas->SizeyY; 

DrawMessages(); 

DrawWi dgets(); 


Next, wewill pll theTogg!l el nvent ory() function. This is the function that runs 
when the user presses |: 


void AAvatar::Togglelnventory() 


{ 


// Get the controller & hud 


APlayerController* PController = Get Worl d()- 
>GetFirstPlayerController(); 


AMyHUD* hud = Cast <AMyHUD>( PController->GetHUD() ); 


// If inventory is displayed, undisplay it. 
if( inventoryShowing ) 
{ 
hud- >clearWidgets(): 
inventoryShowing = false; 
PController->bShowMouseCursor = false: 
return; 
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} 


|| Otherwise, display the player's inventory 
inventoryShowing = true: 
PController->bShowMouseCursor = true; 
for( TMap<FString,int>::Tlterator it = 
Backpack. Createlterator(); it; ++it ) 
{ 
|| Combine string name of the item, with qty eg Cow x 5 


FString fs = 1t->Key + FString::Printf( TEXT(" x %d"), it- 
>Value ); 


UTexture2D* tex; 
if( Icons.Find( it->Key ) ) 
tex = Icons[it->Key]; 
hud- >addWidget( Widget( Icon( fs, tex ) ) }; 
} 


For the preceding code to compile, we need to add a function to AMy HUD: 


} 


void AMyHUD::addWidget( Widget widget ) 


{ 


|| find the pos of the widget based on the grid. 
// draw the icons.. 
FVector2D start( 200, 200 ), pad( 12, 12 ); 
widget.size = FVector2D( 100, 100 ); 
widget. pos = start; 
// compute the position here 
for( int c = 0; c < widgets.Num(); c++ ) 
{ 
|| Move the position to the right a bit. 
widget. pos. X += widget.size.X + pad. X; 
|| If there is no more room to the right then 
// jump to the next line 
if( widget.pos.X + widget.size.X > dims.X ) 
{ 
widget.pos.X = start. X; 
widget. pos. Y += widget.size.Y + pad. Y; 
} 
} 
widgets. Add( widget }; 
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We keep using theBoo! ean variableini nvent oryShowi ng to tell us whether the 
inventory is currently displayed or not. When the inventory is shown, we also show 
the mouse so that the user Knows what he's clicking on. Also, when the inventory is 
displayed, free motion of the player is disabled. The easiest way to disable a player's 
free motion is by simply returning from the movement functions before actually 
moving. The following code is an example: 


void AAvatar::Yaw( float amount ) 


{ 


if( inventoryShowing ) 


{ 


return; // when my inventory 1s showing, 
|} player can't move 


} 
AddControllerYawlnput(200.f*amount * Get Worl d()- 
>Get Del taSeconds()); 


} 


Exercise 


Check out each of the movement functions with thei f( inventoryShowing ) { 
return: } short circuit return. 


Detecting inventory item clicks 


We can detect whether someone Is clicking on one of our inventory items by doing 
a simple hit point-in-box hit. A point-in-box test is done by checking the point of the 
click against the contents of the box. 


Add the following member function tostruct Widget: 


Struct Widget 


{ 
|} .. rest of struct same as before . 
bool hit( FVector2D p ) 
{ 
II +---+ top (0) 
iT | 
|| +---+ bottom (2) (bottom > top) 
ry. R 
return p.X > left() && p.X < right() && p.Y > top() && p.Y < 
bottom): 
} 
yi 
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The point-in-box test is as follows: 





So, itisahitifp. X is all of: 


e Rightofleft() (p.X > left()) 

e Leftofright() (p.X < right()) 

e Below thetop() (p.Y > top()) 

e Abovethebottom) (p.Y < bottom) ) 


Remember that in UE4 (and UI rendering in general) they axis is inverted. In other 
words, y goes down in UE4. This means thatt op() is less than bottom() sincethe 
origin (the(0, 0) point) is at the top-left corner of the screen. 


Dragging elements 


We can drag elements easily. The prst step to enable dragging is to respond to the 
left mouse button click. First, we'll write the function to execute when the left mouse 
button is clicked. In theAvat ar. h ple, add the following prototype to the class 
declaration: 


void MouseClicked(): 


IntheAvatar.cpp ble we can attach a function to execute on a mouse click and pass 
the click request to the HUD, as follows: 


void AAvatar::MouseClicked() 


{ 
APlayerController* PController = Get Worl d()- 
>GetFirstPlayerController(); 


AMyHUD* hud = Cast <AMyHUD>( PController->GetHUD() ); 
hud- >MouseClicked(); 
} 
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Then inAAvatar:: SetupPl ayerl nput Component , wehaveto attach our responder: 


InputComponent->BindAction( "“MouseClickedLMB", IE Pressed, this, 
&AAvatar::MouseClicked ); 


The following screenshot shows how you can attach a render: 


Audio ngine = Input 


HLO Wl Se DES PEP TU GUE he LE ET EP oe] aAa | 


p% These settings are saved in Defaultinput.ini, which is currently writable. 


4 Bindings 


4 Action Mappings -F Ü 


PE inventory $+ X 

Shift kaai Eis ku 
PE MouseClickedLMB + X 

L Left Mouse Button” + a eoi Cis Eo 





Add a member to the A My HUD class: 
Widget* heldWidget; // hold the last touched Widget in memory 


Next, INAMyHUD: : MouseClicked(), we start searching for the Wi dget hit: 


void AMyHUD:: MouseClicked() 

{ 
FVector2D mouse; 
PController->GetMousePosition( mouse. X, mouse.Y ); 
heldWidget = NULL; // clear handle on last held widget 
|| go and see if mouse xy click pos hits any widgets 
for( int c = 0; c < widgets.Num(); c++ ) 


{ 
if( widgets[c].hit( mouse ) ) 
{ 
heldWidget = &widgets[c];// save widget 
return; || stop checking 
} 
} 
} 
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In theAMy HUD: : MouseClicked function, weloop through all the widgets that are 
on the screen and check for a hit with the current mouse position. You can get 
the current mouse position from the controller at any time by simply looking up 
PController->GetMousePosition(). 


Each widget is checked against the current mouse position, and the widget that 

got hit by the mouse click will be moved once a mouse is dragged. Once we have 
determined which widget got hit, we can stop checking, so we havear et urn value 
from theMouseClicked() function. 


Hitting widget is not enough, though. We need to drag the widget that got hit when 
the mouse moves. For this, we need to implement aMouseMoved() function in 
AMy HUD: 


void AMyHUD: : MouseMoved{( } 

{ 
Static FVector2D | ast Mouse; 
FVector2D thisMouse, dMouse; 
PController->GetMousePosition( thisMouse.X, thisMouse.Y ); 
dMouse = thisMouse - | ast Mouse; 
|| See if the left mouse has been held down for 
|} more than 0 seconds. if it has been held down, 
|| then the drag can commence. 
float time = PController->GetIl nput KeyT! meDown( 
EKeys::LeftMouseButton ); 
if( time > 0.f && heldWidget ) 


{ 
|| the mouse is being held down, 
|| move the widget by displacement amt 
heldWidget->pos.X += dMouSe. X; 
heldWidget->pos.Y += dMouse.Y; // y inverted 
} 


lastMouse = thisMouse: 


} 
Don't forget to include a declaration in the My HUD. h ple. 


The drag function looks at the difference in the mouse position between the last 
frame and this frame and moves the selected widget by that amount. A st ati c 
variable (global with local scope) is used to remember the! ast Mouse position 
between the calls for the MouseMoved() function. 
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How can we link the mouse's motion to running the Mous eMoved() function in 

AMy HUD? If you remember, we have already connected the mouse motion in the 
Avatar class. Thetwo functions that we used wereAAvatar::Pitch() (they axis) 
and AAvatar::Yaw() (thex axis). Extending these functions will enable you to 
pass mouse Inputs to the HUD. | will show you theY aw function now, and you can 
extrapolate how Pi tch will work from there: 


void AAvatar::Yaw( float amount ) 


{ 
[|x axis 
if( inventoryShowing ) 
{ 
|| When the inventory is showing, 
|i pass the input to the HUD 
APlayerController* PController = Get Worl d()- 
>GetFirstPlayerController(); 
AMyHUD* hud = Cast <AMyHUD>( PController->GetHUD() ); 
hud- >MouseMoved{ ) : 
return; 
} 
else 
{ 
AddControllerYawlnput(200.f*amount * Get Worl d()- 
>Get Del taSeconds()); 
} 
} 


TheAAvatar: : Yaw() function prst checks whether the inventory is showing or not. 
If it is showing, inputs are routed straight to the HUD, without affecting Avatar . If 
the HUD is not showing, inputs just go toAvatar. 


Exercises 


1. CompletetheAdAvat ar: : Pitch() function (y axis) to route inputs to the 
HUD instead of toAvatar. 


2. MaketheNPC characters from Chapter 8, Actors and Pawns, give the player an 
item (Such as Gol denEgg ) when he goes near them. 
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Summary 


In this chapter, we covered how to set up multiple pickup items for the player to 
see displayed in the level and also pick up. In the next chapter, we will introduce 
M onsters and the player will be able to defend himself against the monsters using 
magic spells. 
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Monsters 


We'll add in a bunch of opponents for the player. 


What I've done in this chapter is added a landscape to the example. The player will 
walk along the path sculpted out for him and then he will encounter an army. There 
is an NPC before he reaches the army that will offer advice. 





The scene: starting to look like a game 
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Landscape 


We haven't covered how to sculpt the landscape in this book yet, but we'll do that 

here. First, you must have a landscape to work with. Start a new ple by navigating 
to File | New. You can choose an empty level or a level with a sky. | chose the one 
without the sky in this example. 


To create a landscape, we have to work from the M odes panel. Make sure that the 
M odes panel is displayed by navigating to Window | Modes: 


AL Maat 
File Edit | Window | Help 
Leve 


1) Details 


Q ' -me Viewports 
í = Layers 


ye Levels 


Recently Pl £ 2 ; 
# i= Scene Outliner 

Basic Wy Statistics 

Lights # Toolbar 

l @ World Settings 

Visual 
General 


BSP = Content Browser 


Volumes $ Developer Tools 


All Classes @ Plugins 


Reset Layout... 
= Comet: l 
save Layout 





ké] Create- Enable Fullscreen 


Displaying the modes panel 
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A landscape can be created in three steps, which are shown in the following 
screenshot, followed by the corresponding steps: 


Ff Modes 


VAP Sa 


4 New Landscape 


® Create New Import from File 


Material None 


Hint: Assign a material to see landscape layers 


Layers 0 elements 
Location 

Rotation 

Scale 

Section Size 

Sections Per Compone 

Number of Component 

Overall Resolution 


Total Components 





1. Click on the landscape icon (the picture of the mountains) in the 
M odes panel. 


2. Click on the M anage button. 
3. Next, click on the Create button in the lower right-hand corner of the screen. 


You should now havea landscape to work with. It will appear as a gray, tiled areain 
the main window: 





— [235] AAS 


www.it-ebooks.info 


Monsters 


The prst thing you will want to do with your landscape scene is add some color 
to it. What's a landscape without colors? Right-click anywhere on your gray, tiled 
landscape object. In the D etails panel at the right, you will see that it is populated 
with information, as shown in the following screenshot: 


fl) Details 


= Landscape2 Landscape.h 
Search 
4 Transform 

Location + 

Rotation = 


Scale + 


4LOD 


Max LODLevel 


Export LOD 


LODDistance Factor 


LODFallott Linear + 


4 Lighting 
Static Lighting LOD a) 
Static Lighting Resc 


Cast Static Shadow 


a Landscape 
Default Phys Materi None 


Streaming Distance) BBY A 


Landscape Material PN None 


Scroll down until you see the Landscape M aterial property. You can select the 
M Ground Grass material for a realistic-looking ground. 





Next, add alight to the scene. You should probably use a directional light so that all 
of the ground has some light on it. 
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Sculpting the landscape 


A yat landscape can be boring. We will at least add some curves and hills to the 
place. To do so, click on the Sculpt button in the M odes panal: 


P YR 


"a 
: an 


4 Brush Settings 
Brush Size 
Brush Fallot 


Use Clay Brush 


4 Tool Settings 





Tool Strength 





To change the landscape, click on the Sculpt button 


The strength and size of your brush are determined by the Brush Size and Tool 
Strength parameters in the M odes window. 


Click on your landscape and drag the mouse to change the height of the turf. 
Once you're happy with what you've got, click on the Play button to try it out. 
The resultant output can be seen in the following screenshot: 
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Play around with your landscape and create a scene. What | did was lower the 
landscape around a yat ground plane, so the player has a well-depned yat area to 
walk on, as shown in the following screenshot: 





Feel free to do whatever you like with your landscape. You can use what I'm doing 
here as inspiration, if you like. | will recommend that you import assets from 
ContentExamples or from StrategyG ame in order to use them inside your game. To 
do this, refer to the Importing assets section in Chapter 10, Inventory System and Pickup 
Items. When you're done importing assets, we can proceed to bring monsters into 
your world. 


Monsters 


We'll start programming monsters in the same way we programmed NPCs and 
Pi ckupl tem. First, we'll write a base class (by deriving from character) to represent 
theMonster class. Then, we'll derivea bunch of blueprints for each monster type. 
Every monster will havea couple of properties in common that determine its 
behavior. These are the common properties: 

e Afloat variable for speed. 


e Afloat variablefor theHi t Poi nts value (I usually use yoats for HP, so we 
can easily model HP leeching effects such as walking through a pool of lava). 


e Ani nt32 variable for the experience gained in defeating the monster. 
e A UCI ass function for the loot dropped by the monster. 
e Afloat variablefor BaseAttackDamage done on each attack. 


e Afloat variablefor Att ackTi meout , which is the amount of time for which 
the monster rests between attacking. 
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e TwouUSphereComponents object: One of them issi ght Spher e—how far 
he can see. The other isAt tackRangeSphere, which is how far his attack 
reaches. TheAttackRangeSphere object is always smaller than Si ght Sphere. 


Derivefrom theCharacter class to create your class for Monst er . You can do this 
in UE4 by going to File | Add Code To Project... and then selecting the Character 
option from the menu for your base class. 


Fill outtheMonster class with the base properties. Make sure that you 
declareUPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
MonsterProperties) sothat the properties of the monsters can be changed 
in the blueprints: 


UCLASS() 
class GOLDENEGG API AMonster : public ACharacter 


{ 
GENERATED UCLASS BODY() 


// How fast he is 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category 
Monster Properties) 


float Speed; 


|| The hitpoints the monster has 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category 
Monster Properties) 

float HitPoints; 


// Experience gained for defeating 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category 
Monster Properties) 

int32 Experience; 


// Blueprint of the type of item dropped by the monster 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Monster Properties) 

UClass* BPLoot; 


// The amount of damage attacks do 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
MonsterProperties) 

float BaseAttackDamage; 


// Amount of time the monster needs to rest in seconds 
|] between attacking 
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UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Monster Properties) 
float AttackTi meout ; 


// Time since monster's last strike, readable in blueprints 
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = 
Monster Properties) 

float TimeSinceLastStrike; 


|| Range for his sight 

UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category = 
Collision) 

USphereComponent* SightSphere; 


|| Range for his attack. Visualizes as a sphere in editor, 
UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category 
Collision) 

USphereComponent* AttackRangeSphere; 


}; 


You will need some bare minimum code in your Monster constructor to get the 
monster's properties initialized. Use the following codein theMonster. cpp ple: 


AMonster::AMonster(const class FObjectIl nitializer& PCIP) : Super(PCIP) 
{ 

Speed = 20; 

HitPoints = 20; 

Experience = 0; 

BPLoot = NULL; 

BaseAttackDamage = 1; 

AttackTi meout = 1.5f; 

TimeSinceLastStrike = 0; 


SightSphere = PCIP. CreateDefaultSubobj ect <USphereComponent > 
(this, TEXT("SightSphere")); 

SightSphere- >AttachTo( RootComponent ); 

AttackRangeSphere = PCIP.CreateDef aul tSubobj ect 


<USphereComponent >(this, TEXT("AttackRangeSphere') ): 
AttackRangeSphere- >AttachTo( RootComponent }; 
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Compile and run the code. Open Unreal Editor and derive a blueprint based on your 
Monster class (call itBP Monster ). Now we can start conbguring your monster's 
Monster properties. 


For the skeletal mesh, we won't use theHer oT PP model for the monster because we 
need the monster to be able to do melee attacks and theHer oT PP model does not 
come with a melee attack. However, some of the models in the M ixamo Animation 
Pack ble have melee attack animations. So download the M ixamo Animation Pack 
ble from the UE4 marketplace (free). 


Learn 


Marketplace 





Inside the pack are some pretty gross models that I'd avoid, but others are quite good 


Next, you should add the M ixamo Animation Pack ple to your project, as shown in 
the following screenshot: 


| Mixamo Animation Pack 
Eny by Mixamo - September 26, 2014 


a Download 15 free characters and animations from Mixamo right here! 
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Now, create a blueprint called BP_ Monster based on your Monster class. Edit 

the blueprint's class properties and select Mixamo_ Adam (it is actually typed as 

M aximo_Adam in the current issue of the package) as the skeletal mesh. Also, select 
M ixamoAnimBP_Adam as the animation blueprint. 


d Animation 


Animation Mode Use Animation Blueprint Fi 


Anim Blueprint Generated Class 


4 Mesh 


Skeletal Mesh 





Select the M aximo_Adam Skeletal Mesh and MixamoAnimBP_Adam for Anim Blueprint Generated Class 


We will modify the animation blueprint to correctly incorporate the melee attack 
animation later. 


While you're editing your BP_ Monster blueprint, change the sizes of the 
SightSphere andAttackRangeSphere objects to values that make sense to you. 
| made my monster's Att ackRangeSphere object just big enough to be about an 
arm's reach (60 units) and hisSi ght Sphere object to be 25 times bigger than that 
(about 1,500 units). 


Remember that the monster will start moving towards the player once the player 
enters the monster's $i ght Sphere, and the monster will start attacking the player 
once the player is inside the monster's At tackRangeSphere object. 
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Mixamo Adam with his AttackRangeSphere object highlighted in orange 


Place a few of your BP_M onster instances inside your game; compile and run. 
Without any codeto drivetheMonst er character to move, your monsters should just 
stand there idly. 


Dcule’o qpuwt'Ipwgni gpeg 
In our game, we will add only a basic intelligence to the Monst er characters. 
The monsters will know how to do two basic things: 

e Track the player and follow him 

e Attack the player 


The monster will not do anything else. You can have the monster taunt the player 
when the player is þrst seen as well, but we'll leave that as an exercise for you. 


Moving the monster — steering behavior 

Monsters in very basic games don't usually have complex motion behaviors. Usually 
they just walk towards the target and attack it. We'll program that type of monster 

in this game, but mind you, you can get more interesting play with monsters that 
position themselves advantageously on the terrain to perform ranged attacks and so 
on. We're not going to program that here, but it's something to think about. 
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In order to get the Monst er character to move towards the player, we need 

to dynamically update the direction of the Monster character moving in each 
frame. To update the direction that the monster is facing, we write code in the 
Monster::Tick() method. 


TheTi ck function runs in every frame of the game. The signature of theTi ck 
function is: 


virtual void Tick(float DeltaSeconds) override: 


You need to add this function's prototype to your AMonster classin your Monster. h 
ble. If we overrideTi ck, wecan place our own custom behavior that the Monster 
character should do in each frame. Here's some basic code that will move the 
monster toward the player during each frame: 


void AMonster::Tick(float DeltaSeconds) 


{ 
Super::Tick( DeltaSeconds ); 


|| basic intel: move the monster towards the player 
AAvatar *avatar = Cast <AAvatar >| 

UGamepl ayStatics::GetPlayerPawn(GetWorld(), 0) ); 
if( !avatar ) return; 


FVector toPlayer = avatar->GetActorLocation() 
GetActorLocation(): 
toPlayer.Normalize();// reduce to unit vector 


|| Actually move the monster towards the player a bit 
AddMovementI nput(toPlayer, Speed*DeltaSeconds); 


// At least face the target 

|| Gets you the rotator to turn something 

|] that looks in the ‘toPlayer’ direction 

FRotator toPlayerRotation = toPlayer. Rotation(); 
toPlayerRotation. Pitch = 0; // 0 off the pitch 
RootComponent- >Set Worl dRotation( toPlayerRotation ); 
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ForAddMovement!nput to work, you must havea controller selected under the 
AlController Class pane! in your blueprint, as shown tn the following screenshot: 


d Al 


AlController Class AlController-~ 7 -EE a E 4 





If you have selected None, callstoAddMovementI nput won't have any effect. 
To prevent this, select either theAl Controller classorthePl ayerController 
class as your AlController Class. 


The preceding code is very simple. It comprises the most basic form of enemy 
intelligence: simply move toward the player by an incrementally small amount in 
each frame. 





Our not-so-intelligent army of monsters chasing the player 
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The result in a series of frames will be that the monster tracks and follows the player 
around the level. To understand how this works, you must remember that theTi ck 
function is called on average about 60 times per second. What this means is that 

in each frame, the monster moves a tiny bit closer to the player. Since the monster 
moves in very small steps, his action looks smooth and continuous (while in reality, 
he is making small jumps and leaps in each frame). 











Discrete nature of tracking: a monster's motion over three superimposed frames 


The reason why the monster moves about 60 times a second is because 
of ahardware constraint. The refresh rate of atypical monitor is 60 Hz, 
so it acts as a practical limiter on how many updates per second are 
useful. Updating at a frame rate faster than the refresh rate is possible, 

al but it is not necessarily useful for games since you will only see a new 

ey picture once every 1/ 60 of asecond on most hardware. Some advanced 

Q physics modeling simulations do almost 1,000 updates a second, but 
arguably, you don't need that kind of resolution for a game and you 
should reserve the extra CPU time for something that the player will 
enjoy instead, such as better Al algorithms. Some newer hardware 
boasts of a refresh rate up to 120 Hz (look up gaming monitors, but don't 
tell your parents | asked you to blow all your money on one). 


The discrete nature of monster motion 


Computer games are discrete in nature. In the preceding screenshot of superimposed 

sequences of frames, the player is seen as moving straight up the screen, in tiny steps. 

The motion of the monster is also in small steps. In each frame, the monster takes one 
small discrete step towards the player. The monster is following an apparently curved 
path as he moves directly toward where the player is in each frame. 
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To move the monster toward the player, we pbrst have to get the player's position. 
Since the player is accessible in a global function, UGamepl ayStatics::GetPlayerPa 
wn, wesimply retrieve our pointer to the player using this function. Next we pnd the 
vector pointing from theMonster (Get ActorLocation() ) function that points to the 
player (avatar->GetActorLocation() ). Weneed to pnd the vector that points from 
the monster to the avatar. To do this, you have to subtract the location of the monster 
from the location of the avatar, as shown in the following screenshot: 





It's a simple math rule to remember but often easy to get wrong. To get the right 
vector, always subtract the source (the starting point) vector from the target (the 
terminal point) vector. In our system, we have to subtract the Monster vector from 
theAvat ar vector. This works because subtracting the Monster vector from the 
system moves the Monster vector to the origin and theAvat ar vector will beto the 
lower left-hand side of the Monster vector: 


Subtract Leaves M@ (0,0) 
-M from every 
vector in this system 


© 
M 


© 
A 





Subtracting the Monster vector from the system moves the M onster vector to (0,0) 
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Be sure to try out your code. At this point, the monsters will be running toward your 
player and crowding around him. With the preceding code that Is outlined, they 
won't attack; they'll just follow him around, as shown in the following screenshot: 





Monster SightSphere 

Right now, the monsters are not paying attention to thesi ght Sphere component. 
That is, wherever the player is in the world, the monsters will move toward him in 
the current setup. We want to change that now. 


To do so, all wehaveto do ishaveMonst er respect thesi ght Sphere restriction. 
If the player is inside the monster's Si ght Sphere object, the monster will give 
chase. Otherwise, the monsters will be oblivious to the player's location and not 
chase the player. 
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Checking to see if an object is inside a sphere is simple. In the following screenshot, 
the point p is inside the sphere if the distanced between p and the centroid c is less 
than the sphere radius, r: 


P is inside the sphere when d is less than r 


So, in our code, the preceding screenshot translates to the following code: 


vold AMonster::Tick(float DeltaSeconds) 
{ 
Super::Tick( DeltaSeconds }; 
AAvatar *avatar = Cast <AAvatar >( 
UGamepl ayStatics::GetPlayerPawn(GetWorld(), 0) ); 
if( !avatar ) return: 
FVector toPlayer = avatar->GetActorLocation() 
GetActorLocation(): 
Float distanceToPlayer = toPlayer. Size(}; 
// if the player is not in the SightSphere of the monster, 
|| go back 
if( distanceToPlayer > SightSphere->GetScaledSphereRadius() ) 
{ 
|| if the player is out of sight, 
|| then the enemy cannot chase 
return; 


} 


toPlayer /= distanceToPlayer; // normalizes the vector 
|| Actually move the monster towards the player a bit 
AddMovementI nput(toPlayer, Speed*DeltaSeconds) ; 

// (rest of function same as before (rotation) ) 
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The preceding code adds additional intelligence to the Monst er character. The 
Monster character can now stop chasing the player if the player is outside the 
monster's Si ght Sphere object. This is how the result will look: 


: = ay ow = TFN i Frere T a 
j af . W i 





A good thing to do here will be to wrap up the distance comparison into a simple 
inline function. We can provide these two inline member functions in theMonster 
header as follows: 


inline bool islinSightRange( float d ) 

{ return d < SightSphere->GetScaledSphereRadius(); } 
inline bool islnAttackRange( float d ) 

{ return d < AttackRangeSphere- >GetScaledSphereRadius(); } 


These functions return the valuet r ue when the passed parameter, d , is inside the 
spheres in question. 


Ani nl ine function means that the function is more like a macro than 
A! a function. M acros are copied and pasted to the calling location, while 
Q functions are jumped to by C++ and executed at their location. Inline 
functions are good because they give good performance while keeping 
the code easy to read and they are reusable. 


Monster attacks on the player 


There are a few different types of attacks that monsters can do. Depending on 
the typeof theMonst er character, amonster's attack might be melee (close range) 
or ranged (projectile weapon). 
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TheMonst er character will attack the player whenever the player isin 
hisAttackRangeSphere. If the player Is out of the range of the monster's 
AttackRangeSphere butthe player isin theSi ght Sphere object of the monster, 
then the monster will move closer to the player until the player is in the monster's 
AttackRangeSphere. 


Melee attacks 


The dictionary debnition of melee is a confused mass of people. A melee attack is one 
that is done at a close range. Picture a bunch of zerglings battling it out with a bunch 
of ultralisks (if you're a StarCraft player, you'll know that both zerglings and ultralisks 
are melee units). Melee attacks are basically close range, hand-to-hand combat. To do 
a melee attack, you need a melee attack animation that turns on when the monster 
begins his melee attack. To do this, you need to edit the animation blueprint in 
Persona, UE4's animation editor. 


Zak Parrish's Persona series is an excellent place to get started with in 
< order to program animations in blueprints:https://www. youtube. 
Q com watch?v=AqYmC2wn7Cg&list=PL6VDVOqa_ mdNW6jJEu9UAS_ 
S400CD ubyp&i ndex=8. 


For now, wewill just program the melee attack and then worry about modifying the 
animation in blueprints later. 


a = WH ' 
F gOpipi 'c'o gryg'y gcr qp 
There are going to be three parts to deþning our melee weapon. The prst part is the 
C++ code that represents it. The second is the model, and the third is to connect the 


code and mode! together using a UE4 blueprint. 


Coding for a melee weapon in C++ 


We will depnea new class, AMel eeWeapon (derived from AAct or ), to represent 
hand-held combat weapons. | will attach a couple of blueprint-editable properties 
to theAMel ee Weapon class, and theAMe! ee Weapon class will look as shown in the 
following code: 


class AMonster: 


UCLASS() 
class GOLDENEGG API AMeleeWeapon : public AActor 


{ 
GENERATED UCLASS BODY() 
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}; 


// The amount of damage attacks by this weapon do 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Mel eeWeapon) 

float AttackDamage; 


// A list of things the melee weapon already hit this swing 
// Ensures each thing sword passes thru only gets hit once 
TArray<AActor*> ThingsHhit; 


|| prevents damage from occurring in frames where 
|| the sword is not Swinging 
bool Swinging; 


// "Stop hitting yourself" - used to check if the 
|| actor holding the weapon is hitting himself 
AMonster *WeaponHol der: 


|| bounding box that determines when melee weapon hit 


UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category 
Mel eeWeapon) 


UBoxComponent* ProxBox: 


UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category 
Mel eeWeapon) 


UStaticMeshComponent* Mesh; 


UFUNCTION( Bl ueprintNativeEvent, Category = Collision) 

void Prox({ AActor* OtherActor, UPrimitiveComponent* OtherComp, 
int32 OtherBodylndex, bool bFromSweep, const FHitResult & 
SweepResult ); 


void Swing(); 
void Rest(); 


Notice how | used a bounding box for Pr 0 xBox , and not a bounding sphere. This is 
because swords and axes will be better approximated by boxes rather than spheres. 
There are two member functions, Rest () andSwing(),whichletMel eeWeapon Know 
what state the actor is in (resting or swinging). There's also aTArray<AAct or*> 

Thi ngsHit property inside this class that keeps track of the actors hit by this melee 
weapon on each swing. Weare programming It so that the weapon can only hit each 
thing once per swing. 
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TheAMel eeWeapon. cpp ble will contain just a basic constructor and some simple 
code to send damages to Ot her Act or when our sword hits him. We will also 
implement the Rest () and Swing() functions to clear the list of things hit. 
TheMel eeWeapon. cpp þle has the following code: 


AMel eeWeapon::AMel eeWeapon(const class FObjectIl nitializer& PCI P) 


{ 


} 


Super (PCI P) 


AttackDamage = 1; 
Swinging = false: 
WeaponHolder = NULL; 


Mesh = PCIP.CreateDefaultSubobj ect <UStaticMeshComponent >(this, 
TEXT("Mesh")); 


RootComponent = Mesh; 


ProxBox = PCIP.CreateDefaultSubobj ect <UBoxComponent >(this, 
TEXT("ProxBox")); 


ProxBox- >OnComponent BeginOverlap.AddDynamic( this, 
&AMel eeWeapon:: Prox ); 


ProxBox- >AttachTo( RootComponent ); 


void AMeleeWeapon:: Prox_Implementation( AActor* OtherActor, 


} 


UPrimitiveComponent* OtherComp, int32 OtherBodylndex, bool 
bFromSweep, const FHitResult & SweepResult ) 


|] don't hit non root components 
if( OtherComp != OtherActor->GetRootComponent() ) 
{ 

return; 


} 


|| avoid hitting things while sword isn't swinging, 
|| avoid hitting yourself, and 

|| avoid hitting the same OtherActor twice 

if( Swinging && OtherActor != WeaponHolder && 
'ThingsHit.Contains(OtherActor) ) 
{ 


OtherActor->TakeDamage( AttackDamage + WeaponHol der- 
>BaseAttackDamage, FDamageEvent(), NULL, this ); 
ThingsHit.Add( OtherActor }; 


} 


void AMel eeWeapon:: Swing() 
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{ 
ThingsHit.Empty(); // empty the list 
Swinging = true; 
} 
void AMel eeWeapon:: Rest (} 
{ 
ThingsHit. Empty(); 
Swinging = false: 
} 


Downloading a sword 

To complete this exercise, we need a sword to put into the model's hand. | added a 
sword to the project called Kilic fromhttp://tf3dm.com/ 3d- model /sword- 95782. 
ht ml by Kaan Gülhan. The following is alist of other places where you will get 
free models: 


e http://www. turbosquid. com/ 

e http://tf3dm.com/ 

e http://archive3d. net/ 

e http://www. 3dtotal.com/ 
Secret tip 


l 
la It might appear at prst onTur boSqui d. com that there are no free 
models. In fact, the secret is that you have to search in the price range 
$0-$0 to pnd them. $0 means free. 


* sword 3d models 





TurboSquid's search for free swords 


| had to edit the kilic sword mesh slightly to bx the initial sizing and rotation. You 
can import any mesh in the Filmbox (FBX) format into your game. The kilic sword 
model is in the sample code package for Chapter 11, M onsters. 
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To import your sword into the UE4 editor, right-click on any folder you want to add 
the mode! to. Navigate to New Asset| Importto| Game | Models..., and from the 
ble explorer that pops up, select the new asset you want to import. If a M odels folder 
doesn't exist, you can create one by simply right-clicking on the tree view at the left 
and selecting N ew Folder in the pane on the left-hand side of the Content Browser 
tab. | selected theki |! ic. fbx asset from my desktop. 


== Content Browser @@ Class Viewer 


WNew~ Alimport = 
@ = | = Game » Models >» 
Fee Search Folders O ie oearch Models 


e a Engine 
1S Game 
> Ea AnimStarterPack 
Ba Blueprints 
Ba Character 
> fi DemoRoom 
> fi ExampleContent 
i Images 
Me Maps 
> i MivamoAnimPack treate Basic Asset 
= Sounds #9 New Folder A Blueprint 
bm StarterContent - 5) 40; options 
is Paper2D é bevel 
s CharacterAl 


Show In Explorer 
Rename = Material 


Set Color 


Particle System 
‘ | 





Importing to your project 
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Creating a blueprint for your melee weapon 


Inside the UE4 editor, create a blueprint based off of AMe! ee Weapon called 
BP Mel eeSword.ConpgureBP Mel eeSword to usethekilic blade model 
(or any blade model you choose), as shown in the following screenshot: 


AL MA EP MeleeSword 


File Edit Asset View Debug Window Help 
a 


w eS 8 + 
o E. ) E 
NA 


Compile Save FindinCB Blueprint Props Simulation 
A Components 


@ Add Component ~ 


è Class Asset 


Mesh kilic2 


oj = ka 
4 Shape 


D Box Extent x 55.59343 [Y 10.10505 [z 3.063145 E 
v 


4 Physics 


Simulate Physics {J 


v 


4 Collision 
Simulation Generate 9 
Generate Overlap Ey 


D Collision Presets OverlapAllDynamic~ 


v 





TheProxBox class will determine whether something was hit by the weapon, 
so we will modify thePr oxBox class such that it just encloses the blade of the sword, 
as shown in the following screenshot: 
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Also, under the Collision Presets pane, it is important to select the NoCollision 
option for the mesh (not BlockAlI). This is illustrated in the following screenshot: 


Mm EP Meleesword 


Edit Asset View Debug Window Help 


A re | i> SY Defaults >E 


E e Simulation 
A Components 


@ Add Component ~ 


e Class 


PrOXBOX 


a) Details 


a Elo- 
4 Collision 
Simulation Generates | § 


Generate Overlap Even 


> Collision Presets NoCollision vw 


stom 


A 
Can Character Step Up 


4 Rendering 
Materials 
Visible 


Hidden in Game 


4 Lighting 
> Lightmass Settings 


Cast Shadow 





If you select BlockAll, then the game engine will automatically resolve all the 
interpenetration between the sword and the characters by pushing away things 
that the sword touches whenever it is swung. The result is that your characters 
will appear to go yying whenever a sword is swung. 


Sockets 


A socket in UE4 is a receptacle on one skeletal mesh for another Act or . You can 
place a socket anywhere on a skeletal mesh body. After you have correctly placed 
the socket, you can attach another Act or to this socket in U E4 code. 


For example, if we want to put a sword in our monster's hand, we'd just have to 
create a socket in our monster's hand. We can attach a helmet to the player by 
creating a socket on his head. 
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Creating a skeletal mesh socket in the monster's 
hand 


To attach a socket to the monster's hand, we have to edit the skeletal mesh that the 
monster is using. Since we used the Mi xamo_ Adam Skeletal mesh for the monster, we 
have to open and edit this skeletal mesh. 


To do so, double-click on the M ixamo_Adam skeletal mesh in the Content Browser 
tab (this will appear as the T-pose) to open the skeletal mesh editor. If you don't see 
M ixamo Adam in your Content Browser tab, make sure that you have imported the 
M ixamo Animation Pack ble into your project from the Unreal Launcher app. 


@ => | T= Game » MixamoAnimPack » Mixamo_Adam 
Te Search Folders Geka ocalch Mesh 


P a Engine 
1 Ba Game 
b ii AnimStarterPack 
Ba Blueprints 


PiVelos 
AsgA 


Bu Character Adam Physics Pepes anen a 


i DemoRoom Set 


> i ExampleContent 
if Images 
i Maps 
4 ie MixamoAnmmPack 
4 ie Mixamo_Adam 
BE Anims 
fae Materials 
{Mesh 


Edit the Maximo_Adam mesh by double-clicking on the Maximo_Adam skeletal mesh object 
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Click on Skeleton at the top-right corner of the screen. Scroll down the tree of bones 
in the left-hand side panel until you pnd the RightH and bone. We will attach a 
socket to this bone. Right-click on the RightH and bone and select Add Socket, 


as shown in the following screenshot: 


A 


File Edit Asset Window Help 


re T Ma n 
E © M «C R A 


Save FindinCB Set Preview Anim Notifies Retarget Manager Import Mesh 


Eco Adem Skeletons 


Skeleton Tree 


Search Skeleton Tree.. 


nl Bones 


Lop; g 


Name Translation Ret Current Scraan Size: 
aRightShoulder Triangles: 14965 


4RightArm Yerticas; 11195 


aRightForeArm 
4RightHandPi Copy Selected Bone Names 
aRightHand! Reset Selected Bone Transforms 


Aggran Siz 


aRightHan 
RightH: Paste Selected Sockets 





KePIeTI( w 


‘wixamo_Adam | 


You can leave the default name (RightH andSocket) or rename the socket if you like, 


as shown in the following screenshot: 
a Right Shoulder 
RightArm 
4RightForeArm 


Next, we need to add a sword to the actor's hand. 
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Attaching the sword to the model 


With the Adam skeletal mesh open, pnd the RightH andSocket option in the tree 
view. Since Adam swings with his right hand, you should attach the sword to his 
right hand. Drag and drop your sword model into the RightH andSocket option. 

You should see Adam grip the sword in the image of the mode at the right-hand 
side of the following screenshot: 


4LeftHandPinky3 Appros Size: 3814654277 
LeftHandPinky4 - 

iNew- Alimport aRightShoulder 

4RightArm 


B y i 
= COmMent BIOWSeET r Class Views 


& "= Game » Models » ; 
4RightForeArm 


PE Search Folders jo) Filters= Sea] 4RightHand 


m 


> S Engine 4 $} RightHandSocket 
4s Game E kilic2 [Preview Only] 
> Sm AnimStarterPack = i aRightHandPinky1 
u Blueprints == 


4RightHandPinky2 
4RightHandPinky3 


Ba Character 
> Zig DemoRoom 
> S ExampleContent RightHandPinky4 
E images . å 
@ Maps 4RightHandRing1 
D i MixamoAnimPack 4RightHandRing2 
Sita - - 
aa Gears 4RightHandRing3 
> fm StarterContent ay RightHandRing4 
> f 
a Paper2D 4RightHandMiddle1 
Characte : 
@= CharacterAl 4RightHandMiddle2 
aRightHandMiddle3 





N ow, click on RightH andSocket and zoom in on Adam's hand. We need to adjust 
the positioning of the socket in the preview so that the sword pts in it correctly. 
Use the move and rotate manipulators to line the sword up so that it pts in his 
hand correctly. 


Pr Socket 


Com! 





Positioning the socket in the right hand so that the sword rests correctly 
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A real-world tip 


M If you have several sword models that you want to switch in and out 

Q of the same RightH andSocket, you will need to ensure quite a bit of 

uniformity (lack of anomalies) between the different swords that are 
supposed to go in that same socket. 


You can preview your animations with the sword in the hand by going to the 
Animation tab in the top-right corner of the screen. 


Skeleton * Mesn * 


C A tioi 
vixamo_Adam a Maximo_Adam [FSR Mixamo_Adam |) 
etails 


5 


OD; 0 4 Skeletal Mesh Socket 

Gurent Screen Sizer iva Socket Name RightHandSocket 
Tiengles; 14965 Hane Mame RightHand x 
vertices; 11139 


oi chonnele: 2 } ati X 8.283529, [Y -11.2963 [Z 3.286584. 
Appro Sizer SSlxiee Re yy D Relative Rotation Roll 4.3624 | Pitch 8.116 | Yaw -179.60 E 


ightHandSoc ket 





Name pists 


Equipping the model with a sword 


However, if you launch your game, Adam won't be holding a sword. That's because 
adding the sword to the socket in Persona is for preview purposes only. 


Code to equip the player with a sword 


To equip your player with a sword from the code and permanently bind it to the 
actor, instantiate an AMel ee Weapon instance and attach itto Ri ght HandSocket after 
the monster instance Is initialized. WedothisinPostl nitializeComponent s() 
since in this function the Mesh object will have been fully initialized already. 
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IntheMonster.h ble, add a hook to select the Blueprint class name (UCI ass ) 
of a melee weapon to use. Also add a hook for a variable to actually store the 
Mel eeWeapon instance using the following code: 


|| The MeleeWeapon class the monster uses 
// If this is not set, he uses a melee attack 


UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Monster Properties) 


UClass* BPMel eeWeapon; 


|] The MeleeWeapon instance (set if the character is using 
|| a melee weapon) 
AActor* Mel eeWeapon; 


Now, select theBP_ Me! eeSword blueprint in your monster's blueprint class. 


In the C++ code, you need to instantiate the weapon. To do so, we need to declare 
and implementaPost! nitializeComponents function for theMonster class. In 
Monster. h, add a prototype declaration: 


virtual void PostIl nitializeComponents() override; 


Post! nitializeComponents runs after the monster object's constructor has 
completed and all the components of the object are initialized (including the 
blueprint construction). So it is the perfect time to check whether the monster has 
aMel ee Weapon blueprint attached to it or not and to instantiate this weapon if it 
does. The following code is added to instantiate the weapon in theMonster. cpp 
implementation of AMonster::PostinitializeComponents(): 


void AMonster::PostInitializeComponents() 


{ 


Super::PostinitializeComponents(): 


// instantiate the melee weapon if a bp was selected 
if( BPMeleeWeapon ) 
{ 
MeleeWeapon = Get Worl d()->SpawnAct or <AMel ee Weapon >( 
BPMeleeWeapon, FVector(), FRotator() }; 


if( MeleeWeapon ) 


{ 
const USkeletal MeshSocket *socket = Mesh- >Get Socket ByName( 
"Ri ghtHandSocket" ); // be sure to use correct 


|| socket name! 
socket- >AttachActor( MeleeWeapon, Mesh ); 
} 
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} 
} 


The monsters will now start with swords in hand if BPMe!l ee Weapon is Selected for 
that monster's blueprint. 





Monsters holding weapons 


Triggering the attack animation 


By default, there is no connection between our C++Monster class and triggering 
the attack animation; in other words, the Mi xamoAni mBP_ Adam class has no way of 
knowing when the monster is in the attack state. 


Therefore, we need to update the animation blueprint of the Adam skeleton 

(Mi xamoAni mBP_ Adam) toincludea query in theMonst er class variable listing 

and check whether the monster is in an attacking state. We haven't worked with 
animation blueprints (or blueprints in general) in this book before, but follow it step 
by step and you should see it come together. 


i | will introduce blueprints terminology gently here, but I will 
< encourage you to havea look at Zak Parrish's tutorial series at 
Q https://www. youtube.com playlist?list=PLZIv_ N0_ 
OlgbYMYfhhdzf Wit UV4j U0YxH for your prst introduction to blueprints. 
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A UE4 blueprint is a visual realization of the code (not to be confused with how 
sometimes people say that a C++ class is a metaphorical blueprint of a class 
instance). In UE4 blueprints, instead of actually writing code, you drag and drop 
elements onto a graph and connect them to achieve desired play. By connecting the 
right nodes to the right elements, you can program anything you want in your game. 


This book does not encourage the use of blueprints since we 


p R are trying to encourage you to write your own code instead. 
Q Animations, however, are best worked with blueprints, because 


that is what artists and designers will know. 


Let's start writing a sample blueprint to get a feel how they work. First, click on the 
blueprint menu bar at the top and select O pen Level Blueprint, as shown in the 
following screenshot: 


Ty z] 


aris q Build Co miie 
Level Blueprints 


= 
| Project Settings 
è GameMode: Edit BP_GameModeGoldenEqq + 
World Override 
GameMode: Not overridden! 
Class Blueprints 
m New Class Blueprint... 


B Open Class Blueprint... 
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The Level Blueprint option executes automatically when you begin the level. Once 
you open this window, you should see a blank slate to create your gameplay on, as 
shown here: 


u 4 EAW says) siftien rise oe 


File Edit View Debug Window Help Search For Help 
Compile Search Blueprint Props Play 
"sa My Blueprint s. Event Graph 
+, +0 
vT > 


L 
Variable Function 


Right-Click to Create New Nodes. 


m= EventGraph 


Ø Show inherited variables 


& Details 


“r= Compiler Results 





Right-click anywhere on the graph paper. Start typing begi n and click on the Event 
Begin Play option from the drop-down list that appears. Ensure that the C ontext 
Sensitive checkbox is checked, as shown in the following screenshot: 


All Actions for this Blueprint Context Sensitive 


4 Add Event 


Begin 
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Immediately after you click on the Event Begin Play option, ared box will appear 
on your screen. It has a single white pin at the right-hand side. This is called the 
execution pin, as shown here: 


€> Event Begin Play 





The prst thing that you need to Know about animation blueprints is the white 
pin execution path (the white line). If you've seen a blueprint graph before, 
you must have noticed a white line going through the graph, as shown in the 
following diagram: 





The white pin execution path is pretty much equivalent to having lines of code lined 
up and run one after the other. The white line determines which nodes will get 
executed and in what order. If anode does not havea white execution pin attached 
to it, then that node will not get executed at all. 
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Drag off the white execution pin from Event Begin Play. Start by typing draw debug 
box inthe Executable actions dialog. Select the prst thing that pops up (f Draw 
D ebug Box), as shown here: 


© Event Begin Play 


Executable actions Context Sensitive 


draw debug box| kad 


d Rendering 
1 Debug 
f Draw Debt ig Box) 





Fill in some details for how you want the box to look. Here, | selected the color blue 
for the box, the center of the box at (0, 0, 100), the size of the box to be (200, 200, 200), 
and a duration of 180 seconds (be sure to enter a duration that is long enough to see 
the result), as shown in the following screenshot: 


© Event Begin Play O | f Draw Debug Box 
>» — b 
[x o.o][y 0.0][2 100.0 | 


Extent 
~ [x 200.0][Y 200.0]{7 200.0 


Line Color 


_ Rotation 
— (R o0][P o0][Y 00] 


©» Duration [180 | 





Now click on the Play button to realize the graph. Remember that you have to pnd 
the world's origin to see the debug box. 


['489'] 


www.it-ebooks.info 


Monsters 


Find the world's origin by placing a golden egg at (0, 0, (some z value)), as shown in 
the following screenshot: 


BP_Pickup_GoldenEgg_2 
BP_Pickup_GoldenEgg_3 
BP_Pickup_GoldenEgg_4 
BP_RedMonster 
BP_RedOpponent 
BP_RedOpponent_10 
BP_RedOpponent_11 
BP_RedOpponent_] 2 
BP_RedOpponent_13 
BP_RedOpponent_14 
BP_RedOpponent_15 
BP_RedOpponent_16 
BP_RedOpponent_17 


sa ta ta Aa Aa Aa Aa ta ba ta O O “i 


56 actors (1 selected) 


A S Details 
— 
SSB BP_Pickup_GoldenEgg 


Search 


4 Transform 
Location w 
Rotation + 


Scale v 


4 Materials 


Element 0 





This is how the box will look in the leval: 





A debug box rendered at the origin 
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Modifying the animation blueprint for Mixamo Adam 


To integrate our attack animation, we have to modify the blueprint. Under Content 
Browser, open up Mi xamoAni mBP_ Adam. 


The prst thing you'll notice is that the graph has two sections: a top section and a 
bottom section. The top section is marked "Basic Character movement...," while the 
bottom section says "M ixamo Example Character A nimation...." Basic character 
movement is in charge of the walking and running movements of the model. We will 
be working in the M ixamo Example Character Animation with Attack and Jump 
section, which is responsible for the attack animation. We will be working in the 
latter section of the graph, shown in the following screenshot: 


Basic Character movement working with Template Character including stafing and jumping 





When you prst open the graph, it starts out by zooming in on a section near the 
bottom. To scroll up, right-click the mouse and drag it upwards. You can also zoom 
out using the mouse whee! or by holding down the Alt key and the right mouse 
button while moving the mouse up. 
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Before proceeding, you might want to duplicate the MixamoA nimBP_Adam 
resource so that you don't damage the original, in case you need to go back and 
change something later. This allows you to easily go back and correct things if you 
pnd that you've made a mistake in one of your modipbcations, without having to 
reinstall a fresh copy of the whole animation package into your project. 





Rename 

Delete 

Replace References 
Export... 

Migrate... 


Show In Explorer 


Copy Reference 


Reference Viewer... 


@ View Documentation - Blueprint 


Connect To Source Control 


M aking a duplicate of the MixamoA nimBP_Adam resource to avoid damaging the original asset 


al 


Q 


92°] 


When assets are added to a project from the Unreal Launcher, a copy 
of the original asset is made, so you can modify MixamoA nimBP_ 
Adam in your project now and get afresh copy of the original assets in 
anew project later. 


www.it-ebooks.info 


Chapter 11 


We're going to do only a few things to make Adam swing the sword when heis 
attacking. Let's do it in order. 


1. Deleting the node that says A ttacking?: 


+ Cast To MxamoCharacter_Master 


> > = Enable Attack 


Object CastFailed [> 


As Miamo Character MasterC 


Target Jump Button Down 





2. Rearrange the nodes, as follows, with the Enable Attack node by itself at 
the bottom: 


a en et ae res set ge 7 
f € j ee Cs f 2 - - 
x WA BS A ts AA Weetie tl Prine eter 





>> Cast To MixamoCharacter_Master Can Jump 


Target | self | Can Jump 
As Mixamo Character Master C ms * 


Should Jump 


Enable Attack 
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3. Next were going to handle the monster that this animation is animating. 
Scroll up the graph a bit and drag the blue dot marked as Return Value in 
the Try Get Pawn Owner dialog. Drop it into your graph, and when the 
pop-up Menu appears, select Cast to M onster (ensure that Context Sensitive 
is checked, or the Cast to M onster option will not appear). The Try Get 
Pawn Owner option gets the Monst er instance that owns the animation, 
which is just theAMonst er class object, as shown in the following screenshot: 


J Try Get Pawn Owner 


Target | self Return Value 


Actions taking a(n) Pawn Reference Context Sensitive 


4 Utilities 
4Casting 
>> Cast To BP_RedMonster 
=> Cast To Mon 





4. Click on + in the Sequence dialog and drag another execution pin from 
the Sequence group to the Cast to M onster node instance, as shown in the 
following screenshot. This ensures that the Cast to M onster instance actually 
gets executed. 
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Tira % 
nen 


Delile Example Character Animat 


Add pin + 


>> Cast To MixamoCharacter_Master 


Object 


»+ Cast To Monster 





5. The next step is to pull out the pin from the As M onster terminal of the Cast 
to M onster node and look for the Is in Attack Range Of Player property: 


»+ Cast To Monster 


Object Cast Failed Enable Attack 


As Monster 


Actions taking a(n) Monster Reference Context Sensitiy 


4Collision 
is in Attack 
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6. Takethe white execution pin from the Cast to M onster node at the 
left-hand side and drop it into the Is in Attack Range Of Player node 
at the right-hand side: 


»+ Cast To Monster FIs in Attack Range Of Player 


Object Cast Failed [> 
Return Value 


As Monster 





This ensures a transfer of control from the Cast to M onster operation to the 
Is in Attack Range Of Player node. 


7. Pull the white and red pins over to the SET node, as shown here: 


+ Cast To Monster — FF Is in Attack Range Of Player . 


— p & i + = 
= | b b SET 


Target Return Value 


Object 


Enable Attack 


As Monster 





The equivalent pseudocode of the preceding blueprint is something 
similar to the following: 
S 


Q if( Monster.islnAttackRangeOfPlayer() ) 
{ 


Monster. Animation = The Attack Ani mation: 


} 


Test your animation. The monster should swing only when heis within the 
player's range. 


Code to swing the sword 


We want to add an animation notify event when the sword is swung. First, declare 
and add a blueprint callable C++ function to your Monster class: 


|| in Monster. h: 
UFUNCTION( BlueprintCallable, Category = Collision ) 
void SwordSwung(); 
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TheBl ueprintCal lable statement means that it will be possible to call this function 
from blueprints. In other words, SwordSwung() will bea C+ function that we can 
invoke from a blueprints node, as shown here: 


// tn Monster.cpp 
void AMonster:: SwordSwung( ) 
{ 

if( MeleeWeapon ) 

{ 

Mel eeWeapon- >Swi ng() : 

} 

} 


Next open the Mixamo_Adam_Sword_ Slash animation by double-clicking on it 
from your Content Browser (it should bein MixamoAnimPack/M ixamo_Adam/ 
Anims/M ixamo_Adam_Sword_ Slash). Scrub the animation to the point where 
Adam starts swinging his sword. Right-click on the animation bar and select N ew 
Notify under Add Notify... , as shown in the following screenshot: 


Mizamo Adam sword 


E  PlayParticleEffect 


PlaySound 


End 


Jump 
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Name the notipcation Swor dSwung: 


Notify Name — 
im =wordSwung g 





Save the animation and then open up your version of MixamoAnimBP_Adam again. 
Underneath the SET group of nodes, create the following graph: 


Q> AnimNotify_SwordSwung ++ Cast To Monster — | | J} Sword Swung 


> —— D 


Object Cast Failed [> 


Target 
AS Monster 





TheAnimN otify_SwordSwung node appears when you right-click in the graph 
(with Context Sensitive turned on) and start typing Swor dSwung. The Cast To 

M onster node is again fed in from the Try Get Pawn Owner node as in step 2 of the 
M odifying the animation blueprint for M ixamo Adam section. Finally, Sword Swung is 
our blueprint-callable C++ function in theAMonster class. 


If you start the game now, your monsters will execute their attack animation 
whenever they actually attack. When the sword's bounding box comes in contact 
with you, you should see your HP bar go down a bit (recall that the HP bar was 
added at the end of Chapter 8, Actors and Pawns, as an exercise). 
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Monsters attacking the player 


Projectile or ranged attacks 


Ranged attacks usually involve a projectile of some sort. Projectiles are things such 
as bullets, but they can also include things such as lightning magic attacks or brebal| 
attacks. To program a projectile attack, you should spawn a new object and only 
apply the damage to the player if the projectile reaches the player. 


To implement a basic bullet in UE4, we should derive a new object type. | derived 
aABullet class from theAActor class, as shown in the following code: 


UCLASS() 
class GOLDENEGG API ABullet : public AActor 


{ 
GENERATED UCLASS BODY{ ) 


|| How much damage the bullet does. 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Properties) 

float Damage: 


|| The visible Mesh for the component, so we can see 
|| the shooting obj ect 


UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category = 
Collision) 


['499'] 


www.it-ebooks.info 


Monsters 


}; 


UStaticMeshComponent* Mesh; 


|| the sphere you collide with to do impact damage 


UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category = 
Collision) 


USphereComponent* ProxSphere: 


UFUNCTI ON( BlueprintNativeEvent, Category = Collision) 

void Prox({ AActor* OtherActor, UPrimitiveComponent* OtherComp, 
int32 OtherBodylndex, bool bFromSweep, const FHitResult & 
SweepResult ); 


TheABul | et class has a couple of important members in it, as follows: 


Afloat variable for the damage that a bullet does on contact 

A Mesh variable for the body of the bullet 

A ProxSphere variable to detect when the bullet pnally hits something 
A function to be run when Pr ox near an object is detected 


The constructor for the ABul | et class should have the initialization of the Mes h 
and ProxSphere variables. In the constructor, we set Root Component to being the 
Mesh variable and then attach theProxSphere variable to theMesh variable. The 
ProxSphere variable will be used for collision checking, and collision checking for 
theMesh variable should be turned off, as shown in the following code: 


ABullet::ABullet(const class FObjectIl nitializer& PCIP) : Super(PCl P) 


{ 


Mesh = PCIP.CreateDefaultSubobj ect <UStaticMeshComponent >(this, 
TEXT("Mesh")); 


RootComponent = Mesh; 


ProxSphere = PCIP.CreateDefaultSubobj ect <USphereComponent >(this, 
TEXT("ProxSphere")): 


ProxSphere->AttachTo( RootComponent ); 


ProxSphere->OnComponent BeginOverlap.AddDynamc( this, 
GABullet:: Prox ); 


Damage = 1; 
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We initialized the Damage variableto1 in the constructor, but this can be changed 

in the U E4 editor once we create a blueprint out of theABul | et class. Next, the 
ABullet::Prox_I mpl ement ati on() function should deal damages to the actor hit if 
we collide with the other actor's Root Component , using the following code: 


void ABullet::Prox_Implementation( AActor* OtherActor, 
UPrimitiveComponent* OtherComp, int32 OtherBodyl ndex, bool bFromSweep, 
const FHitResult & SweepResult ) 


{ 
if( OtherComp != OtherActor->GetRootComponent() ) 


{ 
|} don't collide w/ anything other than 
// the actor's root component 
return; 


} 


OtherActor->TakeDamage( Damage, FDamageEvent(), NULL, this ); 
Destroy(); 
} 


Dwngvr j { uleu 
To make bullets yy through the level, you can use UE4's physics engine. 
Create a blueprint based on theABul | et class. | selected Shape Sphere for the mesh. 


The bullet's mesh should not have collision physics enabled; instead we'll enable 
physics on the bullet's bounding sphere. 


Conbguring the bullet to behave properly is mildly tricky, so we'll cover this in four 
steps, as follows: 


1. Select [ROOT] ProxSphere in the Components tab. ThePr oxSphere variable 
should be the root component and should appear at the top of the hierarchy. 


2. Inthe Details tab, check both Simulate Physics and Simulation G enerates 
Hit Events. 


3. From the Collision Presets dropdown, select Custom.... 
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4. Check the Collision Responses boxes as shown; check Block for most types 
(WorldStatic, WorldD ynamic, and so on) and check Overlap only for Pawn: 


AL MEP BesicBuller 
File Edit Asset View Debug Window Help 


F 
E © į i> 
s Bei E] 4 s 
Compile Save FindinCB Blueprint Props Simulation 
A Components 


@ Add Component ~ 
e Class 


Class Asset 
Mesh Shape 


3 Details 


4 Rendering 
Visible 


Hidden in Game 


4 Collision 
Simul n Ge 


og 


Object Responses 
y Static 


op 





The Simulate Physics checkbox makes thePr oxSpher e property experience gravity 
and the impulse forces exerted on it. An impulse is a momentary thrust of force, 
which we'll use to drive the shot of the bullet. If you do not check the Simulation 
Generate Hit Events checkbox, then the ball will drop on the yoor. What BlockAll 
Collision Preset does is ensure that the ball can't pass through anything. 
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If you drag and drop a couple of theseBP Bul! et objects from the Content Browser 
tab directly into the world now, they will simply fall to the yoor. You can kick them 
once they are on the the yoor. The following screenshot shows the ball object on 

the yoor: 





However, wedon't want our bullets falling on the yoor. We want them to be shot. 
So let's put our bulletsin theMonster class. 


Adding bullets to the monster class 


Add a membe to the Monster class that receives a blueprint instance reference. 
That's what theUCI ass object type is for. Also, add a blueprint conpbgurable y oat 
property to adjust the force that shoots the bullet, as shown in the following code: 


|| The blueprint of the bullet class the monster uses 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Monster Properties) 

UClass* BPBullet; 

|| Thrust behind bullet launches 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
Monster Properties) 

float BulletLaunchl mpul se; 


Compile and run the C++ project and open your BP_ Monster blueprint. You can 
now select a blueprint class under BP Bul | et , as shown in the following screenshot: 


cai a CE 
iaaah A0 





BFBullet BP_BasicBullet+ $ -E e S 4 
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Once you've selected a blueprint class type to instantiate when the monster shoots, 
you have to program the monster to shoot when the player is in his range. 


Where does the monster shoot from? Actually, he should shoot from a bone. If you're 
not familiar with the terminology, bones are just reference points in the model mesh. 
A model mesh is usually made up of many "bones." To see some bones, open up the 
Mixamo_Adam mesh by double-clicking on the asset in the Content Browser tab, as 
shown in the following screenshot: 


amo Adam Keeton 


Window 


* a, 
= í à] 
iff zt 
L ' j (7 

view Anim Notif f 


etarget Manager 


Search Skeleton Tree 


rave Socera 7 
i Lopo 


des , Currant £ 
aHips 
45pine 
4Spinel 
4Spine2 
aNeck 
aHead 
HeadTop_End 
aLeftShoulder OTE =< LeftHand 
aLeftArm 
,LeftForeArm 
LeftHand 
4LeftHandThum 
,LeftHandThu 
aLeftHandTt 


mobail Anima + 
, LeftHandindex 


4 LeftHandind Anima = 
4 LeftHandin Anima » 





Go to the Skeleton tab and you will see all the monster's bones in a tree view listin 
the left-hand side. What we want to do is select a bone from which bullets will be 
emitted. H ere I've selected theLef t Hand option. 
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RS. An artist will normally insert an additional bone into the model 
Q mesh to emit the particle, which is likely to be on the tip of the 
nozzle of a gun. 


Working from the base model mesh, we can get the Mesh bone's location and have 
the monster emit the Bul | et instances from that bone in the code. 


The complete monster Ti ck and At tack functions can be obtained using the 
following code: 


void AMonster::Tick(float DeltaSeconds) 


{ 
Super::Tick( DeltaSeconds ); 


|| move the monster towards the player 
AAvatar *avatar = Cast <AAvatar >| 
UGamepl ayStatics::GetPlayerPawn(GetWorld(), 0) ); 


if( !avatar ) return: 
FVector playerPos = avatar->GetActorLocation(): 
FVector toPlayer = playerPos - GetActorLocation(): 


float distanceToPlayer = toPlayer.Size(); 


// If the player is not the SightSphere of the monster, 


|] go back 
if( distanceToPlayer > SightSphere->GetScaledSphereRadius() ) 
{ 
// If the player is OS, then the enemy cannot chase 
return; 
} 


toPlayer /= distanceToPlayer; // normalizes the vector 


// At least face the target 

// Gets you the rotator to turn something 

|] that looks in the ‘toPlayer’ direction 

FRotator toPlayerRotation = toPlayer. Rotation(); 
toPlayerRotation. Pitch = 0; // 0 off the pitch 
RootComponent- >Set Worl dRotation( toPlayerRotation ); 


if( islnAttackRange(distanceToPlayer) ) 
{ 

|| Perform the attack 

if( !TimeSinceLastStrike ) 
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{ 
Attack(avatar): 


} 


TimeSinceLastStrike += DeltaSeconds: 
if( TimeSinceLastStrike > AttackTi meout ) 


{ 
TimeSinceLastStrike = 0; 
} 
return; // nothing else to do 
} 
else 
{ 


|| not in attack range, so walk towards player 
AddMovementI nput(toPlayer, Speed*DeltaSeconds) ; 
} 
} 


TheAMonster::Attack function is relatively simple. Of course, we þrst need to add 
a prototype declaration in theMonster. h plein order to write our function in the 
. cpp ple: 


void AMonster::Attack(AActor* thing); 
In Monster. cpp, weimplement theAt t ack function, as follows: 


void AMonster::Attack(AActor* thing) 


{ 

if( MeleeWeapon ) 

{ 
|] code for the melee weapon swing, if 
|| a melee weapon is used 
Mel eeWeapon- >Swi ng(); 

} 

else if( BPBullet ) 

{ 


// If a blueprint for a bullet to use was assigned, 

|| then use that. Note we wouldn't execute this code 

// bullet firing code if a MeleeWeapon was equipped 

FVector fwd = GetActorForwardVector(): 

FVector nozzle = GetMesh()->GetBoneLocation( "RightHand" ); 


nozzle += fwd * 155;// move it fwd of the monster so it 
doesn't 


// collide with the monster model 
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FVector toOpponent = thing->GetActorLocation() - nozzle: 
toOpponent.Normalize(); 

ABullet *bullet = Get Worl d()->SpawnAct or <ABul | et >( 
BPBullet, nozzle, RootComponent->Get Component Rot ati on()): 


if( bullet ) 
{ 
bullet->Firer = this; 
bull et->ProxSphere- >Addl mpul se( 
fwd*BulletLaunchl mpulse ); 
} 
else 
{ 
GEngi ne- >AddOnScreenDebugMessage( 0, 5.f, 


FColor::Yellow, "monster: no bullet actor could be spawned. 
is the bullet overlapping something?" ); 


} 
} 
} 


We leave the code that implements the melee attack as it is. Assuming that the 
monster is not holding a melee weapon, we then check whether theBP Bul | et 
member is set. If theBP Bul | et member is set, it means that the monster will 
create and bre an instance of the BP Bul | et blueprinted class. 


Pay special attention to the following line: 


ABullet *bullet = Get Worl d()->SpawnActor<ABullet>(BPBul let, 
nozzle, RootComponent->GetComponentRotation() ); 


This is how we add anew actor to the world. TheSpawnActor() function puts 
an instance of UCLASS that you pass, ats pawnLoc, with some initial orientation. 


After we spawn the bullet, we call theAdd! mpul se() function on itsProxSphere 
variable to rocket it forward. 


Player knockback 


To add a Knockback to the player, | added a member variable to theAvat ar class 
called knockback.A kKnockback happens whenever the avatar gets hurt: 


FVector knockback; // in class AAvatar 
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In order to bgure out the direction to knock the player back when he gets hit, we 
need to add some code to AAvat ar: : TakeDamage. Compute the direction vector 
from the attacker towards the player and store this vector in theknockback variable: 


float AAvatar::TakeDamage(float Damage, struct FDamageEvent const & 
DamageEvent, AController* Eventi nstigator, AActor* DamageCauser) 


{ 
|| add some knockback that gets applied over a few frames 


knockback = GetActorLocation() - DamageCauser- 
>GetActorLocation(): 


knockback. Nor malize(); 
kKnockback *= Damage * 500; // knockback proportional to damage 


} 
InAAvatar:: Tick, weapply the knockback to the avatar's position: 


void AAvatar::Tick( float DeltaSeconds } 


{ 
Super::Tick( DeltaSeconds ); 


|] apply knockback vector 
AddMovementI nput( knockback, 1.f ); 


// half the size of the knockback each frame 
kKnockback *= 0. 5f: 


} 


Since the knockback vector reduces in size with each frame, it becomes weaker over 
time, unless the kKnockback vector gets renewed with another hit. 


Summary 


In this chapter, we explored how to instantiate monsters on the screen that run after 
the player and attack him. In the next chapter, we will give the player the ability to 
defend himself by allowing him to cast spells that damage the monsters. 
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The player does not ye have a means to defend himself. We will equip the player 
with a very useful and interesting way, of doing so called magic spells. Magic spells 
will be used by the player to affect monsters nearby. 


Practically, spells will be a combination of a particle system with an area of effect 
represented by a bounding volume. The bounding volume is checked for contained 
actors in each frame. When an actor is within the bounding volume of a spell, then 
that actor is affected by that spell. 


The following is a screenshot of the blizzard and force peld spells, with their 
bounding volumes highlighted in orange: 
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Visualization of the blizzard spell can be seen at the right, with along, box-shaped 
bounding volume. Visualization of the force beld spell, with a spherical bounding 
volume, for pushing monsters away, is shown in the following screenshot: 





In each frame, the bounding volume is checked for contained actors. Any actor 
contained in the spell's bounding volume is going to be affected by that spell for 
that frame only. If the actor moves outside the spell's bounding volume, the actor 
will no longer be affected by that spell. Remember, the spell's particle system is a 
visualization only; the particles themselves are not what will affect game actors. The 
Pi ckupl t em class we created in Chapter 8, Actors and Pawns can be used to allow the 
player to pick up items representing the spells. We will extend thePi ckup! t em class 
and attach the blueprint of a spell to cast each Pi ckupl t em. Clicking on a spell's 
widget from the HUD will cast it. The interface will look something like this: 








Items the player has picked up, including four different spells 
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We'll begin the chapter by describing how to create our own particle systems. 
We'll then move on to wrap up the particle emitter into aSpel! class, and write 
aCastSpell!() function for the avatar to be able to actually cast spells. 


The particle systems 


First, we need a placeto put all our snazzy effects. In your Content Browser 

tab, right-click on the Game root and create a new folder called ParticleSystems. 
Right-click on that new folder, and select New Asset| Particle System, as shown 
in the following screenshot: 
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See this Unreal Engine 4 Particle Systems guide for information 
` on how unreal particle emitters work:https:// www. youtube. 
Q com/watch?v=0XK2Xbd7D9w&i ndex=1&list=PLZIv_N0_ 

Ol1gYDLyB3LVfj Yl cbBe8NgR8t. 
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Double-click on the N ewParticleSystem icon that appears, as shown in the 
following screenshot: 





You will bein Cascade, the particle editor. A description of the environment is 
shown in the following screenshot: 
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There are several different panes here, each of which shows different information. 
They areas follows: 


e Atthetop left isthe Viewport pane. This shows you an animation of the 
current emitter as its currently working. 


At the right is the Emitters pane. Inside it, you can see a single object called 
Particle Emitter (you can have more than one emitter in your particle 
system, but we don't want that now). The listing of modules of Particle 
Emitter appears listed under it. From the preceding screenshot, we have the 


Required, Spawn, Lifetime, Initial Size, Initial Velocity, and Color Over 
Life modules. 


Changing particle properties 

The default particle emitter emits crosshair-like shapes. We want to change that to 
something more interesting. Click on the yellow Required box under Emitters pane, 
then under M aterial in the Details panel, typeparticles.A list of all the available 


particle materials will pop up. Choose m yare Oloption to create our prst particle 
system, as shown in the following screenshot: 
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N ow, let's change the behavior of the particle system. Click on the Color Over 
Life entry under the Emitters pane. The D etails pane at the bottom shows the 
information about the different parameters, as shown in the following screenshot: 
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In the D etails pane of Color Over Life entry, | increased X, but not Y and not Z. 
This gives the particle system a reddish glow. (X is red, Y is green, and Z is blue). 
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Instead of editing the raw numbers, however, you can actually change the particle 
color more visually. If you click on the greenish zigzag button beside the Color Over 
Life entry, you will see the graph for Color Over Life displayed in the Curve Editor 
tab, as shown in the following screenshot: 
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We can now change the Color Over Life parameters. The graph in the Curve Editor 
tab displays the emitted color versus the amount of time the particle has been alive. 

You can adjust the values by dragging the points around. Pressing Ctrl +left mouse 
button adds a new point to a line: 





15.00 


Ctrl +click adds points to lines. 


You can play around with the particle emitter settings to create your own 
spell visualizations. 
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Settings for the blizzard spell 

At this point, we should rename our particle system, from N ewParticle System 
to something more descriptive. Let's rename it P_Blizzard. You can rename your 
particle system by simply clicking on it and pressing F 2. 





We will tweak some of the settings to get a blizzard particle effect spell. Perform the 
following steps: 


1. Under the Emitters tab, click on the Required box. In the D etails pane, 
change the Emitter material to m_yare Olas shown: 
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Under the Spawn module, change the spawn rate to 200. This increases the 
density of the visualization, as shown: 
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3. Under the Lifetime module, increase the M ax property from 1.0 to 2.0. This 
introduces some variation to the length of time a particle will live, with some 
of the emitted particles living longer than others. 
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4. Under theInitial Size module, change the Min property size to 12.5in X,Y, 
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5. Under theInitial Velocity module, change the M in/ M ax values to the 


values shown: 
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6 The reason we're having the blizzard blow in +X Is because the player's 
forward direction starts out in +X. Since the spell will come from the player's 
hands, we want the spell to point in the same direction as the player. 


7. Under the Color Over Life menu, change the blue (Z) value to 100.0. 
You will see an instant change to a blue glow: 


4 Color 


4 Color Over Life 
4 Distribution 
4 Constant Curve 
4 Points 
40 
In Val 
> Out Val 
> Arrive Tangent 


> Leave Tangent 





| Pecquirac 
Sper 
Lifetime 
Initial Size 
Initial Velocity 


Sele Grae lyre 


| 


Q Distribution Vector Constant Curve + he 


| 


2elements + QJ 2 


5 members 

CTS - 

CLES (LS CS - 
S S S - 


Now it's starting to look magical! 
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8. Right-click on the blackish area below the Color Over Life module. Choose 
Location | Initial Location: 
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10. You should havea blizzard that looks like this: 





11. Move the camera to a position you like, then click on the Thumbnail option 
in the top menu bar. This will generate a thumbnail icon for your particle 
system in the Content Browser tab. 
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Clicking Thumbnail at the top menu bar will generate a mini icon for your particle system 
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Spell class actor 


ThesSpel |! class will ultimately do damage to all the monsters. Towards that end, 

we need to contain both a particle system and a bounding box insidetheSpel! class 
actor. When aSpel | class is cast by the avatar, theSpel | object will be instantiated 
into the level and start Ti ck() functioning. On every Ti ck() of theSpe!l | object, any 
monster contained inside the spell's bounding volume will be affected by that Spel! . 


TheSpel | class should look something like the following code: 


UCLASS() 
class GOLDENEGG API ASpell : public AActor 


{ 
GENERATED UCLASS BODY() 


|| box defining volume of damage 
UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category 
Spell) 

TSubobjectPtr<UBoxComponent> ProxBox; 


|| the particle visualization of the spel 
UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category 
Spell) 

TSubobjectPtr<UParticleSystemComponent> Particles; 


// How much damage the spell does per second 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Spell) 
float DamagePer Second: 


|| How long the spell lasts 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Spell) 
float Duration: 


// Length of time the spell has been alive in the level 
float Ti meAl ive; 


|| The original caster of the spell (so player doesn't 
|| hit self) 
AActor* Caster: 


|| Parents this spell to a caster actor 
void SetCaster( AActor* caster ); 


|| Runs each frame. override the Tick function to deal damage 
|| to anything in ProxBox each frame. 
virtual void Tick( float DeltaSeconds ) override; 
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There are only three functions we need to worry about implementing, namely 
theASpel!::ASpel!() constructor, theASpel!::SetCaster() function, and 
theASpel!::Tick() function. 


Open theSpel!.cpp ble Add alineto includetheMonster.h ple, So we can access 
the depnition of Monster objects insidethespel!.cpp ble as shown in the following 
line of code: 


#include "Monster. h" 


First, the constructor, which sets up the spell and initializes all components is shown 
in the following code: 


ASpell::ASpell (const class FPostConstructIl nitializeProperties& 
PCIP) : Super( PCI P) 
{ 
ProxBox = PCIP.CreateDefaul tSubobj ect <UBoxComponent >(this, 
TEXT("ProxBox")): 
Particles = PCIP.CreateDefaultSubobj ect <UParticleSystemComponent >(t 
his, 
TEXT( "ParticleSystem')); 


| The Particles are the root component, and the ProxBox 
/ 1s a child of the Particle system 

/ |f it were the other way around, scaling the ProxBox 
/ would also scale the Particles, which we don't want 
RootComponent = Particles: 

ProxBox- >AttachTo( RootComponent ); 


=, ee Oe, Oe, 


Duration = 3; 
DamagePerSecond = 1; 
TimeAlive = 0; 


PrimaryActorTick. bCanEverTick = true;//required for spells to 
[|] tick! 
} 


Of particular importance is the last line here, Pri maryActorTick. bCanEverTick = 
true. If you don't set that, your Spe! | objects won't ever haveTi ck() called. 
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Next, wehavetheSet Cast er() method. This is called so that the person who casts 
the spell is Known to theSpe!! object. We can ensure that the caster can't hurt 
himself with his own spells by using the following code: 


void ASpell::SetCaster( AActor *caster ) 
{ 


Caster = caster; 
AttachRootComponentTo( caster->GetRootComponent() }; 


} 


Finally, wehavethedS pel! :: Tick () method, which actually deals damage to all 
contained actors, as shown in the following code: 


void ASpell::Tick( float DeltaSeconds ) 


{ 
Super::Tick( DeltaSeconds ); 


|| search the proxbox for all actors in the volume. 
TArray<AActor*> actors; 
ProxBox- >GetOverlappingActors( actors ); 


|| damage each actor the box overlaps 
for( tnt c = 0; c < actors. Num); c++ ) 


{ 
|| don't damage the spell caster 
if( actors c ] != Caster ) 
{ 
// Only apply the damage if the box is overlapping 
// the actors ROOT component. 
// This way damage doesn't get applied for simply 
|| overlapping the SightSphere of a monster 
AMonster *monster = Cast <AMonster>( actors[c] ); 
if( monster && ProxBox->lsOverlappingComponent( monster- 
>CapsuleComponent ) ) 
{ 
monster->TakeDamage( DamagePerSecond*DeltaSeconds, 
FDamageEvent(), 0, this ); 
} 
|| to damage other class types, try a checked cast 
|| here.. 
} 
} 
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Ti meAlive += DeltaSeconds:; 
if( TimeAlive > Duration ) 
{ 
Destroy(); 
} 
} 


TheASpell::Tick() function does a number of things, as follows: 


e Gets all actors overlapping Pr ox Box. Any actor that is not the caster gets 
damaged if the component overlapped is the root component of that object. 
The reason we have to check for overlapping with the root component is 
because If we don't, the spell might overlap the monster'sSi ght Sphere, 
which means we will get hits from very far away, which we don't want. 


e Notices that if we had another class of thing that should get damaged, we 
would have to attempt a cast to each object type specipcally. Each class type 
might have a different type of bounding volume that should be collided 
with, other types might not even haveCapsul eComponent (they might have 
ProxBox orProxSphere). 


e Increases the amount of time the spell has been alive for. If the spell exceeds 
the duration it is allotted to be cast for, it is removed from the level. 


N ow, let's focus on how the player can acquire spells, by creating an individual 
Pi ckupl t em for each spell object that the player can pick up. 


Drwor tipvpi ‘qwt'ur gnu 

Compile and run your C++ project with theSpel | class that we just added. We need to 
create blueprints for each of the spells we want to be able to cast. In the Class Viewer 
tab, start to typeSpel | , and you should see your Spel | class appear. Right-click on 
Spell, and create a blueprint called BP_Spell_ Blizzard, and then double-click to open 
it, as Shown in the following screenshot: 


: — 
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Blueprint Path | 
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Inside the spell's properties, choose the P_Blizzard spell for the particle emitter, 
as shown in the following screenshot: 


4 Particles 


Template P _Mizzanid 





Scroll down until you reach the Spell category, and update the D amage Per Second 
and Duration parameters to values you like. Here, the blizzard spell will last 3.0 
seconds, and do 16.0 damage total per second. After three seconds, the blizzard 

will disappear. 


4 Spell 
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Duration 





After you have conbgured the D efault properties, switch over to the Components 
tab to make some further modipcations. Click on and change the shape of Pr ox Box 
so that its shape makes sense. The box should wrap the most intense part of the 
particle system, but don't get carried away in expanding its size. TheProxBox object 
shouldn't be too big, because then your blizzard spell would affect things that aren't 
even being touched by the blizzard. As shown in the following screenshot, a couple 
of outliers are ok. 





Your blizzard spell is now blueprinted and ready to be used by the player. 
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Picking up spells 

Recall that we previously programmed our inventory to display the number of 
pickup items the player has when the user presses |. We want to do more than 
that, however. 





aalogo] (Persistent) 


Items displayed when the user presses | 


To allow the player to pick up spells, we'll modify the Pi c kup! t em class to include 
a slot for a blueprint of the spell the player casts by using the following code: 


|| inside class APickupltem: 

// If this item casts a spell when used, set it here 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = Item) 
UClass* Spell; 


Once you've added theUCI ass* Spel! property to theAPi ckup! tem class, 
recompile and rerun your C++ project. Now, you can proceed to make blueprints 
of Pi ckupl t em instances for your Spe! | objects. 
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Creating blueprints for Pickupltems that cast spells 


Create a Pickuplitem blueprint called BP_Pickup Spell Blizzard. Double-click on it 
to edit its properties, as shown in the following screenshot: 


Create /Game/Blueprints/BP_Pickup_Spell_Blizzard 
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| set the blizzard item's pickup properties as follows: 


The name of the item is Blizzard Spell, and pve are in each package. | took a 
screenshot of the blizzard particle system and imported it to the project, so the 
Icon is selected as that image. Under spell, | selected BP_Spell_ Blizzard as the 
name of the spell to be cast (not BP_Pickup_Spell_ Blizzard), as shown in the 
following screenshot: 
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| selected a blue sphere for theMesh class of thePi ckup! t em class. For Icon, | took a 
screenshot of the blizzard spell in the particle viewer preview, saved it to disk, and 
imported that image to the project (see the images folder in the Content Browser tab 
of the sample project). 
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Place a few of thesePi ckup! tem in your level. If we pick them up, we will have some 
blizzard spells in our inventory. 


Picked up 5 Blizzard Spell 


Blizzard Spell x 15 





Left: Blizzard spell pickup items in game world. Right: Blizzard spell pickup item in inventory. 
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Now we need to activate the blizzard. Since we already attached the left mouse click 
in Chapter 10, Inventory System and Pickup Items to dragging the icons around, let's 
attach the right mouse click to casting the spell. 


Attaching right mouse click to cast spell 


The right mouse click will have to go through quite a few function calls before calling 
the avatar's Cast Spel! method. The call graph would look something like 
the following screenshot: 


Person right clicks => AAvatar::MouseRightClicked() 
==> AMyHUD::MouseRightClicked() 


==> AAvatar::CastSpell() 





A few things happen between right click and spell cast. They are as follows: 


e Aswesaw before, all user mouse and keyboard interactions are routed 
through theAvat ar object. When theAvat ar object detects a right-click, it 
will pass the click event to HUD through AAvatar::MouseRightClicked(). 


e Recall from Chapter 10, Inventory System and Pickup Items where we used a 
struct Widget classto keep track of the items the player had picked up. 
struct Widget only had three members: 

Struct Widget 
{ 
[con icon; 
FVector2D pos, size; 
///.. and some member functions 


ie 


We will need to add an extra property forstruct Widget class to remember 
the spell it casts. 


TheHUD will determine if the click event was inside Widget In 
AMy HUD: : MouseRi ghtClicked(). 


e Ifthe click was on theWi dget that casts a spell, the HUD then calls the avatar 
back with the request to cast that spell, by callingAAvatar::CastSpell(). 
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Writing the avatar's CastSpell function 


We will implement the preceding call graph in reverse. We will start by writing the 
function that actually casts spells in the game, AAvatar::CastSpell(),asshownin 
the following code: 


void AAvatar::CastSpell( UClass* bpSpell ) 

{ 
// instantiate the spell and attach to character 
ASpell *spell = Get Worl d()->SpawnActor<ASpell>(bpSpell, 
FVector(0), FRotator(0) ); 


if( spell ) 

{ 
spell->SetCaster( this }; 

} 

else 

{ 
GEngine->AddOnScreenDebugMessage( 1, 5.f, FColor:: Yellow, 
FString("can't cast ") + bpSpell->GetName() }; 

} 


} 


You might pnd that actually calling a spell is remarkably simple. There are two basic 
steps to casting the spell: 


e |nstantiate the spell object using the world object's SpawnAct or function 

e Attach it to the avatar 
OncetheSpel | object is instantiated, itsTi ck() function will run each frame when 
that spell isin the level. On eachTick(),theSpel! object will automatically feel out 


monsters within the level and damage them. A lot happens with each line of code 
mentioned previously, so let's discuss each line separately. 


Instantiating the spell — GetWorld()->SpawnActor‘() 


To create theSpel| object from the blueprint, we need to call theSpawnAct or ( ) 
function from the Wor | d object. TheSpawnAct or() function can take any blueprint 
and instantiate it within the level. Fortunately, theAvat ar object (and indeed any 
Actor object) can get a handle to the Wor | d object at any time by simply calling the 
Get Wor! d() member function. 


The line of code that brings theSpe! | object into the level is as follows: 


ASpell *spell = Get Worl d()->SpawnActor<ASpell >( bpSpell, 
FVector(0), FRotator(0) ); 
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There are a couple of things to note about the preceding line of code: 


e bpSpel! must bethe blueprint of aSpel! object to create. The<ASpel | > 
object in angle brackets indicates that expectation. 


e Thenew Spel! object starts out at the origin (0, 0, 0), and with no additional 
rotation applied to it. This is because we will attach theSpel | object to the 
Avatar object, which will supply translation and direction components for 
theSpel |! object. 


if(spell) 
We always test if the call toSpawnAct or <ASpel | >() Succeeds by checking f ( 
spell ). Ifthe blueprint passed to theCast Spel! object is not actually a blueprint 


based on theASpel! class, then theSpawnAct or() function returns aNULL pointer 
instead of aSpel | object. If that happens, we print an error message to the screen 
indicating that something went wrong during spell casting. 


spell->SetCaster(this) 

When instantiating, if the spell does succeed, we attach the spell to theAvat ar object 
by callingspel|->SetCaster( this ) .Remember, in the context of programming 
within theAvat ar class, thet his method is a reference to theAvat ar object. 


Now, how do we actually connect spell casting from UI inputs, to call 
AAvatar::CastSpell() function in the prst place? We need to do some HUD 
programming again. 


Writing AMyHUD::MouseRightClicked() 


The spell cast commands will ultimately come from the HUD. We need to write a 
C+ function that will walk through all the HUD widgets and test to see if a click is 
on any one of them. If the click ison awi dget object, then that wi dget object should 
respond by casting its spell, if it has one assigned. 


We have to extend our Wi dget object to havea variable to hold the blueprint 
of the spell to cast. Add a member to yourstruct Widget object by using the 
following code: 


Struct Widget 
{ 


Icon icon; 
|| bpSpell is the blueprint of the spell this widget casts 
UClass *bpSpell; 
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FVector2D pos, size; 
Widget(lcon ticon, UClass *i1ClassName) 


} 


Now, recall that our Pi ckupl t em had the blueprint of the spell it casts attached to it 
previously. However, when thePi ckupl t em class is picked up from the level by the 
player, then the Pi ckup! t em class is destroyed. 


|i From APickupltem:: Prox _|I mpl ementation(): 

avatar->Pickup( this ); // give this 1temto the avatar 

|| delete the pickup item fromthe level once it is picked up 
Destroy(); 


So, we need to retain the information of what spell each Pi c kup! t em casts. We can 
do that when that Pi ckupl t emis rst picked up. 


InsidetheAAvat ar class, add an extra map to remember the blueprint of the spell 
that an item casts, by item name: 


|| Put this in Avatar. h 
TMap<FString, UClass*> Spells: 


Now inAAvatar:: Pi ckup() , remember the class of spell the Pi ckup! tem class 
instantiates with the following line of code: 


|| the spell associated with the item 
Spells. Add(item->Name, item->Spell); 


Now, inAAvatar::Toggl el nventory(),weceanhavethewi dget object that 
displays on the screen. Remember what spell it is supposed to cast by looking up 
theSpells map. 


Find the line where we create the widget, and just under it, add assignment of the 
bpSpell objects that the Wi dget casts: 


// In AAvatar::Togglelnventory() 
Widget w( Icon( fs, tex ) ); 
w.bpSpell = Spells[it->Key]; 


Add the following function to AMy HUD, which we will set to run whenever the right 
mouse button is clicked on the icon: 


vol d AMyHUD:: MouseRi ght Clicked() 

{ 
FVector2D mouse; 
APlayerController *PController = Get Worl d()- 
>GetFirstPlayerController(); 
PController->GetMousePosition( mouse. X, mouse.Y }: 
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for( int c = 0; c < widgets. Num); c++ ) 
{ 
if( widgets[c].hit( mouse ) ) 
{ 
AAvatar *avatar = Cast <AAvatar >( 
UGamepl ayStatics::GetPlayerPawn(GetWorld(), 0) ); 
if( widgets[c].spell Name ) 
avatar->CastSpell( widgets[c].spellName }; 
} 
} 
} 


This ts very similar to our left mouse click function. We simply check the click 
position against all the widgets. If any Wi dget was hit by the right-click, and that 
Widget haSaSpel| object associated with it, then a spell will be cast by calling the 
avatar's Cast Spel! () method. 


Activating right mouse button clicks 


To connect this HUD function to run, we need to attach an event handler to the 
mouse right-click. We can do so by going to Settings | Project Settings, and from 


the dialog that pops up, adding an Input option for Right M ouse Button, as shown 
in the following screenshot: 


E Engine - Input 


ADUT SAIS. Nerang 


is binding 


jm These settings are saved in Defaultinput.ini, which is currently writable. 


Audio 


= ce 
4 Bindings 
4 Action Mappings —- Qj 
F inventory |+ x 
ar Eus Eeun fle feces E 


Fa MouseClickedL MEB $+ X 


- 
` Right Mouse Button oo” Enua ke E kau E 
Platforms — 
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DeclareafunctioninAvatar.h/Avatar.cpp called MouseRi ght Clicked() withthe 
following code: 


void AAvatar::MouseRi ght Clicked() 


{ 
if( inventoryShowing ) 
{ 
APlayerController* PController = Get Worl d()- 
>GetFirstPlayerController(): 
AMyHUD* hud = Cast <AMyHUD>( PController->GetHUD() ); 
hud- >MouseRi ght Clicked(); 
} 
} 


Then, inAAvatar::SetupPl ayer! nput Component (),weshould attach 
MouseClickedRMB eventto that MouseRi ght Cli cked() function: 


|| In AAvatar::SetupPlayerlnputComponent(): 


InputComponent->BindAction( "“MouseClickedRMB", IE Pressed, this, 
&AAvatar::MouseRi ghtClicked )}; 


We have pnally hooked up spell casting. Try it out, the gameplay is pretty cool, 
as shown in the following screenshot: 
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Creating other spells 


By playing around with particle systems, you can create a variety of different spells 
that do different effects. 


Vj g'Otg'ur gm 
You can easily create a bre variant of our blizzard spell by changing the color of the 
particle system to red: 


Viewport 


a ae es 
-— Details 
eer 


Search p E O~ 


4 Color 
4 Color Over Life 5 
4 Constant Curve 5 
4 Points 2elements + Ü 2 
40 5 members ms 





The out val of the color changed to red 
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Exercises 
Try the following exercises: 
1. Lightning spell: Create a lightning spell by using the beam 
particle. Follow Zak's tutorial for an example of how beams are 
created and shot in a direction, athttps:// www. youtube. com/ 


watch?v=ywd3l FOUMV8&list=PLZl v_NO OlgYDLyB3LVfj Yl cbBe8NqR8t &i n 
dex=7. 


2. Forceþeld spell: A forcepeld will deyect attacks. It is essential for any 
player. Suggested implementation: Derive a subclass of ASpel | called 
ASpel | ForceFiel d.Add abounding sphere to the class, and use that 
intheASpel | ForceFi el d::Tick() function to push the monsters out. 


What's next? | would highly recommend that you expand on our little game here. 
H ere are some ideas for expansion: 


e Create more environments, expand the terrain, add in more houses 
and buildings 
e Add quests that come from NPCs 
e Debne more melee weapons such as, swords 
e Depnearmor for the player, such as shields 
e Add shops that sell weapons to the player 
e Add more monster types 
e Implement loot drops for monsters 
You have literally thousands of hours of work ahead of you. If you happen to bea 


solo programmer, form working relationships with other souls. You cannot survive 
in the game marketplace on your own. 


It's dangerous to go alone—Take a friend. 


Summary 


This concludes this chapter. You have come along way. From not knowing anything 
about C+- programming at all, to hopefully being able to string together a basic 
game program in UE4. 
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